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Preface 



This publication lists the job control tasks needed to enter jobs into the operating system, 
control the system's processing of jobs, and request the resources needed to run jobs. To 
perform the tasks, programmers code job control statements. This publication describes how to 
code these statements, which consist of: 

• Job control languiage (JCL) statements 

• Job entry subsystem 2 (JES2) control statements 

• Job entry subsystem 3 (JES3) control statements 

This publication is designed as a reference book, to be used while coding the statements. It 
contains some introductory material. Full explanations of the job control tasks are presented in 
a companion book, MVS I Extended Architecture JCL User's Guide, GC28-1351. 

Who Should Use this Publication 

This book is needed by system and application programmers who enter programs into the 
operating system. Those using this book should understand the concepts of job management 
and data management. 

Information in This Publication 

Chapter 1. Job Control Statements: This chapter introduces the job control statements. 

Chapter 2. Job Control Tasks: This chapter contains charts of job control tasks and the 
statements and parameters that can be used to perform the tasks. 

Chapter 3. Format of Job Control Statements: This chapter describes the fields in job control 
statements and how to continue fields onto following statements. 

Chapter 4, Syntax: This chapter describes: 

• Notation used to show the syntax of job control parameters. 

• Character sets used in coding job control statements. 

• Backward references and their use. 

Chapter 5. Cataloged and In-Stream Procedures: This chapter presents the information needed 
to code and use cataloged and in-stream procedures. 

Chapter 6. Job Control Statements on the Output Listing: This chapter shows how job control 
statements are identified on the job log output listing. 
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Chapters 7 through 19: These chapters detail the coding of each JCL statement, in alphabetical 
order, and of each parameter, in alphabetical order by statement. The chapters are: 

Chapter 7. Command Statement 
Chapter 8. Comment Statement 
Chapter 9. CNTL Statement 
Chapter 10. DD Statement 
Chapter 11. Special DD Statements 
Chapter 12. Delimiter Statement 
Chapter 13. ENDCNTL Statement 
Chapter 14. EXEC Statement 
Chapter 15. JOB Statement 
Chapter 16. Null Statement 
Chapter 17. OUTPUT JCL Statement 
Chapter 18. PEND Statement 
Chapter 19. PROC Statement 

For the DD, EXEC, JOB, and OUTPUT JCL statements, the chapter introduction includes 
charts summarizing all the parameters, their values, and their purposes. These charts should 
help the new JCL coder select parameters and act as a reminder for the experienced coder. 

Except for chapter 11, each of these chapters cover only one statement. In them, the 
parameters are listed alphabetically. For each statement and parameter, the following 
information is given, as needed: 

• Parameter type: positional or keyword, required or optional, and if it is supported by only 
JES2 or JES3. 

• Purpose of the parameter. 

• References to related information in other IBM publications. 

• Syntax and coding rules. 

• Parameter or subparameter definitions: how to code each parameter or subparameter. 

• Defaults if you do not code a statement, parameter, or subparameter. 

• Overrides: statements that this statement overrides or is overridden by or parameters that 
this parameter overrides or is overridden by. 

• Relationship to other parameters, including other parameters or subparameters that must 
not be coded with this one. 

• Relationship to other control statements. 

• On EXEC statement that calls a procedure, for EXEC statement parameters. 

• Location in the JCL. 

• Other information required to code the statement or parameter, 

• Examples. 



IV MVS/XA JCL Reference 



Chapter 20. JES2 Statements: This chapter details the coding of JES2 control statements. 
Chapter 21. JESS Statements: This chapter details the coding of JES3 control statements. 
Chapter 22. Reference Tables: This chapter contains the following reference tables: 

• Mutually exclusive DD statement parameters. 

• Capacities of direct access devices. 

• Track capacities. 



Guide to Using this Publication 



If your system contains MVS/System Product - JES2 Version 2 (program number 5740-XC6), 
JES2 information in this manual refers to the JES2 function in the MVS/System Product 
Version 2, unless otherwise noted. 

If your system contains MVS/System Product - JES3 Version 2 (program number 5665-291), 
JESS information in this manual refers to the JES3 function in the MVS/System Product 
Version 2, unless otherwise noted. 

Your system must contain Resource Access Control Facility (RACE) Program Product 
(program number 5740-XXH), in order for you to specify the PROTECT parameter on your 
DD statements and to use the GROUP, PASSWORD, and USER parameters on the JOB 
statement. 

JCL Statements no Longer Supported or Supported Differently: Parameters introduced in OS 
are not supported in MVS/System Product are: 

• Main storage hierarchy support and rollout/roUin. The system will check the 
HIERARCHY and ROLL parameters only for correct syntax. 

• The SEP parameter, the AFF parameter, and the UNIT = SEP subparameter on the DD 
statement. The system will check them only for correct syntax. The job will fail if they are 
coded incorrectly. 

JCL DD parameters supported differently are: 

• SPLIT and SUBALLOC. Their values are converted internally to SPACE requests. When 
the SUBALLOC keyword is coded, the DD statement for which space is allocated becomes 
a dummy DD. 

• For a JES3 system, the UNIT parameter on a DD statement that names a cataloged data 
set cannot specify a device type that conflicts with the cataloged device type. For example, 
a 3330 and a 3375. 

Supported in MVS/System Product Version 1 but not in Version 2 are the CODE and FRID 
subparameters of the DCB parameter on the DD statement. 
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Programs 



Hardware 
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Print Management Facility User's Guide and Reference, SH35-0059. 
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2821 Control Unit Component Description, GA24-3312. 
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Punch, GC21-5097. 

0S/VS2 IBM S540 Programmer's Reference, GC24-5111. 
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Forms Design Reference Guide for the IBM S800 Printing Subsystem, GA26-1633. 
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Summary of Amendments 



Summary of Amendments 

for GC28-1352-1 

as Revised December 30, 1985 

This revision contains the following: 

• Support for MVS/System Product - Version 2 Release 1.5 with changes to the way JES2 
handles held sysout data sets. 

• Support for Resource Access Control Facility (RACF) Version 1 Release 7 with the 
following changes: 

- Protection of individual data sets on tape volumes with labels. 

- Protection of unlabeled tape volumes. 

- Use of all 44 characters of the DSNAME for protecting tape data sets. 

These RACF changes for tape data set protection only apply if you also have 
MVS/Extended Architecture Data FaciUty Product (DFP) Version 2 Release 1 .0 installed. 

• Maintenance updates. 



Summary of Amendments 
for GC28-1352-0 
as updated August 15, 1985 
by TNL GN28-5091 

This technical newsletter supports the Resource Access Control FaciUty (RACF) option for JES 
early user verification and the feature for propagation of the user and group identification. The 
changes are in the USER, PASSWORD, and GROUP parameter descriptions for the JOB 
statement. 



Summary of Amendments XV 
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Statements 



Chapter 1. Job Control Statements 



This chapter lists in Figure 1-1 all the job control statements and gives the purpose of each 
statement. Each statement is described in detail in later chapters. 



Statement 


Name 


Purpose 


JCL Statements 


// command 


JCL command 


Enters a system operator command through the input stream. The 
command statement is used primarily by the operator. 

Note: JESS ignores the JCL command statement. 


//* comment 


comment 


Contains comments. The comment statement is used primarily to 
document a program and its resource requirements. 


// CNTL 


control 


Marks the beginning of one or more program control statements. 


// DD 


data definition 


Identifies and describes a data set. 


/* 


delimiter 


Indicates the end of data placed in the input stream. 

Note: Any two characters can be designated by the user to be the 
delimiter. 


// ENDCNTL 


end control 


Marks the end of one or more program control statements. 


// EXEC 


execute 


Marks the beginning of a job step; assigns a name to the step; identifies 
the program or the cataloged or in-stream procedure to be executed in 
this step. 


// JOB 


job 


Marks the beginning of a job; assigns a name to the job. 


// 


null 


Marks the end of a job. 


// OUTPUT 


output JCL 


Specifies the processing options that the job entry subsystem is to use for 
printing a sysout data set. 


// PEND 


procedure end 


Marks the end of an in-stream procedure. 


// PROC 


procedure 


Marks the beginning of an in-stream procedure and may mark the 
beginning of a cataloged procedure; assigns default values to parameters 
defined in the procedure. 
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Statements 



Statement 


Purpose 


JES2 Control Statements 


/*$command 


Enters JES2 operator commands through the input stream. 


/♦JOBPARM 


Specifies certain job-related parameters at input time. 


/♦MESSAGE 


Sends messages to the operator via the operator console. 


/*NETACCT 


Specifies an account number for a network job. 


/♦NOTIFY 


Specifies the destination of notification messages. 


/♦OUTPUT 


Specifies processing options for sysout data set(s). 


/♦PRIORITY 


Assigns a job queue selection priority. 


/♦ROUTE 


Specifies the output destination or the execution node for the job. 


/♦SETUP 


Requests mounting of volumes needed for the job. 


/♦SIGNOFF 


Ends a remote job stream processing session. 


/♦SIGNON 


Begins a remote job stream processing session. 


/♦XEQ 


Specifies the execution node for a job. 


/♦XMIT 


Indicates a job or data stream to be transmitted to another JES2 node 
or eligible non-JES2 node. 


JES3 Control Statements 


//♦♦command 


Enters JES3 operator commands, except ♦DUMP and ♦RETURN, through 
the input stream. 


//♦DATASET 


Begins an input data set in the input stream. 


//♦ENDDATASET 


Ends the input data set that began with a //♦DATASET statement. 


//♦ENDPROCESS 


Ends a series of //♦PROCESS statements. 


//♦FORMAT 


Specifies the processing options for a sysout or JES3-managed print or 
punch data set. 


//♦MAIN 


Defines selected processing parameters for a job. 


//♦NET 


Identifies relationships between predecessor and successor jobs in a 
dependent job control net. 


//♦NETACCT 


Specifies an account number for a network job. 


//♦OPERATOR 


Sends messages to the operator. 


//♦♦PAUSE 


Halts the input reader. 


//♦PROCESS 


Identifies a nonstandard job. 


//♦ROUTE 


Specifies the execution node for the job. 


/♦SIGNOFF 


Ends a remote job stream processing session. 


/♦SIGNON 


Begins a remote job stream processing session. 
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Chapter 2. Job Control Tasks 



For your program to execute on the computer and perform the work you designed it to do, 
your program must be processed by your operating system. Your operating system consists of 
a base control program (BCP) and the job entry subsystem (JES2 or JES3) installed with it. 

For the operating system to process a program, programmers must perform certain job control 
tasks. These tasks are performed through the job control statements, which consist of: 

JCL statements 

JES2 control statements 

JES3 control statements 



Entering Jobs 



Job Steps: You enter a program into the operating system as a job step. A job step consists of 
the job control statements that request and control execution of a program and request the 
resources needed to run the program. A job step is identified by an EXEC statement. The job 
step can also contain data needed by the program. The operating system distinguishes job 
control statements from data by the contents of the records. 

Jobs: A job is a collection of related job steps. A job is identified by a JOB statement. 

Input Streams: Jobs placed in a series and entered through one input device form an input 
stream. The operating system reads an input stream into the computer from an input/output 
(I/O) device or an internal reader. The input device can be a card reader, a magnetic tape 
device, a terminal, or a direct access device. An internal reader is a buffer that is read from a 
program into the system as though it were an input stream. 

Cataloged and In-Stream Procedures: You often use the same set of job control statements 
repeatedly with Uttle or no change, for example, to compile, assemble, Unk-edit, and execute a 
program. To save time and prevent errors, you can prepare sets of job control statements and 
place, or catalog, them in a partitioned data set known as a procedure Ubrary. Such a set of 
job control statements in the system procedure library, SYSl.PROCLIB, is called a cataloged 
procedure. 

To test a procedure before placing it in the catalog, place it in an input stream and execute it; 
a procedure in an input stream is called an in-stream procedure. The maximum number of 
in-stream procedures you can code in any job is 15. 

Steps in a Job: A job can be simple or complex; it can consist of one step or of many steps 
that call many in-stream and cataloged procedures. A job can consist of up to 255 job steps, 
including all steps in any procedures that the job calls. Specification of a greater number of 
steps produces unpredictable results. 
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Tasks 



Processing Jobs 



The operating system performs many job control tasks automatically. You can influence the 
way your job is processed by the JCL and JES2 or JES3 parameters you code. For example, 
the job entry subsystem selects jobs for execution, but you can speed up or delay selection of 
your job by the parameters you code. 

Requesting Resources 

Data Set Resources: To execute a program, you must request the data sets needed to supply 
data to the program and to receive output records from the program. 

Sysout Data Set Resources: A sysout data set is a system-handled output data set. This data 
set is placed temporarily on direct access storage. Later, at the convenience of the system, the 
system prints it, punches it, or sends it to a specified location. Because sysout data sets are 
processed by the system, the programmer can specify many parameters to control that 
processing. 

Task Charts 

The following charts list the job control tasks in four groups: 

• Entering jobs in Figure 2-1 on page 2-3 

• Processing jobs in Figure 2-2 on page 2-6 

• Requesting data set resources in Figure 2-3 on page 2-7 

• Requesting sysout data set resources in Figure 2-4 on page 2-10 

For each task, the charts list the parameters and statements that can be used to perform it. In 
many cases, the same task can be performed using different parameters on different statements. 
Where a parameter can appear on both a JOB and EXEC statement, it applies to the entire job 
when coded on the JOB statement but only to a step when coded on an EXEC statement. 

The system is designed to enable users to perform many types of job control in many ways. To 
allow this flexibihty, only two job entry tasks are required: 

• Identification: The job must be identified in the jobname field of a JOB statement. 

• Execution: The program or procedure to be executed must be named in a PGM or PROC 
parameter on an EXEC statement. 

Therefore, the following statements are the minimum needed to perform a job control task: 



//jobname JOB 
// EXEC 



P GM=p r o gr am- n ame 
PROC=procedure-name 
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Tasks 



TASKS FOR 

ENTERING 

JOBS 


STATEMENTS AND PARAMETERS FOR TASK | 


JCL Statements 


JES2 Statements 


JES3 Statements 


JOB 


EXEC 


Otlier JCL 


Identification 












of job 


jobname field 




null statement 
(JESS only) 






of step 




stepname field 








of procedure 






PROC 
PEND 






of account 


accounting 

information or 
pano in JOB JES2 

accounting 

information 


ACCT 




/♦NETACCT 


//*NETACCT 


of programmer 


programmer's- 

name and 
room in JOB 

JES2 accounting 

information 
USER 






ROOM 
on /*JOBPARM 


PNAME, BLDG, 
DEPT, ROOM, 
and USERID 

on //*NETACCT 


Execution 












of program 




PGM 








of procedure 




PROC 








when restarting and 
with checkpointing 


RESTART 
RD 


RD 


SYSCHK DD 


RESTART 
on /*JOBPARM 


FAILURE and 
JOURNAL 

on //*MAIN 


deadUne or periodic 










DEADLINE 

on //*MAIN 


when dependent on 
other jobs 










//*NET 


at remote node 








/♦ROUTE XEQ 

/*XEQ 
/*XMIT 


//♦ROUTE XEQ 



Figure 2-1 (Part 1 of 3). Tasks for Entering Jobs 
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Tasks 



TASKS FOR 

ENTERING 

JOBS 


STATEMENTS AND PARAMETERS FOR TASK | 


JCL Statements 


JES2 Statements 


JES3 Statements 


JOB 


EXEC 


Other JCL 


Job input control 












by holding job en- 
trance 


TYPRUN 
CLASS 








HOLD, UPDATE, or 
CLASS on //♦MAIN 
//♦NET 


by holding local 
input reader 










//♦PAUSE 


by copying input 
stream (JES2 only) 


TYPRUN 
CLASS 










from remote work 
station 








/♦SIGNON 
/*SIGNOFF 


/♦SIGNON 
/♦SIGNOFF 


Communication 












from JCL to system 






Command 


/*$command 


//♦♦command 


from JCL to operator 








/♦MESSAGE 


//♦OPERATOR 


from JCL to pro- 
grammer 


Comment field 
unless no 
parameter field 


Comment field 


//♦comment, 
also comment 
field on all state- 
ments but null 




Comment field on 
//♦ENDPROCESS 

and //♦PAUSE 


from JCL to program 




FARM 








from system to oper- 
ator 










FETCH on //♦MAIN 
WARNING on 
BYTES, CARDS, 
LINES, and PAGES 

on //♦MAIN 


from system to TSO 
userid 


NOTIFY 






/♦NOTIFY 


ACMAIN 
on //♦MAIN with 
JOB NOTIFY 


from TSO userid to 
system 










USER on //♦MAIN 


from functional sub- 
system to pro- 
grammer 






PIMSG on 
OUTPUT JCL 






through job log 


MSGCLASS 
MSGLEVEL 
log in JOB 

JES2 accounting 

information 




JESDS on 
OUTPUT JCL 


NOLOG 
on /♦JOBPARM 





Figure 2-1 (Part 2 of 3). Tasks for Entering Jobs 
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Tasks 



TASKS FOR 
ENTERING 
JOBS 


STATEMENTS AND PARAMETERS FOR TASK | 


JCL Statements 


JES2 Statements 


JES3 Statements 


JOB 


EXEC 


Other JCL 


Protection 












through RACF 


GROUP 

PASSWORD 

USER 










Resource control 












of program library 






JOBLIB DD 
STEPLIB DD 
DD defining 
PDS member 






of procedure library 








PROCLIB 
on /*JOBPARM 


PROC and UPDATE 

on //*MAIN 


of address space 


REGION 
ADDRSPC 


REGION 
ADDRSPC 






LREGION 

on //*MAIN 


of processor 








SYSAFF 
on /*JOBPARM 


SYSTEM 

on //*MAIN 


of spool partition 










SPART and 
TRKGRPS 

on //*MAIN 
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Tasks 



TASKS FOR 

PROCESSING 

JOBS 


STATEMENTS AND PARAMETERS FOR TASK | 


JCL Statements 


JES2 Statements 


JES3 Statements 


JOB 


EXEC 


Other JCL 


Processing control 












by terminating exe- 
cution 


COND 


COND 






CANCEL in BYTES, 
CARDS, LINES, 
and PAGES 

on //*MAIN 


by timing execution 


TIME 

or time in JOB 

JES2 accounting 

information 


TIME 




TIME 
on /♦JOBPARM 




for testing: 

(1) by altering 
usual processing 

(2) by dumping 
after error 


TYPRUN 
CLASS 


PGM = IEFBR14 

PGM = JCLTEST 
PGM = JSTTEST 
(JES3 only) 


SYSABEND DD 
SYSMDUMP DD 
SYSUDUMP DD 

To format dump 
on 3800 Print- 
ing Subsystem, 
FCB = STD3and 
CHARS = DUMP 
on dump DD 




//♦PROCESS 
//♦ENDPROCESS 

DUMP in BYTES, 
CARDS, LINES, 
and PAGES 

on //*MAIN 


Performance control 












by job class assign- 
ment 


CLASS 








CLASS on //*MAIN 


by selection priority 


PRTY 






/♦PRIORITY 




by dispatching prior- 
ity 




DPRTY 








by performance 
group assignment 


PERFORM 










by I/O-to-processing 
ratio 










lORATE 

on //*MAIN 



Figure 2-2. Tasks for Processing Jobs 
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Tasks 



TASKS FOR 
REQUESTING DATA 
SET RESOURCES 


STATEMENTS AND PARAMETERS FOR TASK | 


JCL Statements 


JES2 Statements 


JES3 Statements 


DD 


OUTPUT JCL 


Other JCL 


Identification 












of data set 


DSNAME 








UPDATE 

on //*MAIN 


of in-stream data set 


* or DATA 

SYSIN DD 

DLM 




/* or XX delimiter 




//*DATASET 
//*ENDDATASET 


of data set on 3540 
Diskette Input/Out- 
put Unit 


DSID 










through catalog 


JOBCAT DD 
STEPCAT DD 










through label 


label-type 
on LABEL 










by location on tape 


data-set- 
sequence-number 
on LABEL 










as TCAM message 
data set 


QNAME 










from or to terminal 


TERM 










Description 












of status 


DISP 










of data attributes 


DCB 

AMP 











Figure 2-3 (Part 1 of 3). Tasks for Requesting Data Set Resources 
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Tasks 



TASKS FOR 
REQUESTING DATA 
SET RESOURCES 


STATEMENTS AND PARAMETERS FOR TASK | 


JCL Statements 


JES2 Statements 


JES3 Statements 


DD 


OUTPUT JCL 


Other JCL 


Protection 












through RACF 


PROTECT 










for ISO/ANSI/FIPS 
Version 3 tapes 


ACCODE 










by passwords 


PASSWORD and 
NOPWREAD 
on LABEL 










of access to BSAM 
and EDAM data 
sets 


IN and OUT 
on LABEL 










Allocation 

of device 


UNIT 


______ 








CLASS 
on JOB 
(JES3 only) 




SETUP, MSS, 
and CLASS 

on //*MAIN 


of tape or direct ac- 
cess volume 


VOLUME 
MSVGP 








EXPDTCHK 
and RINGCHK 

on //*MAIN 


of direct access space 


SPACE 










of virtual I/O 


UNIT 

DSNAME- tem- 
porary data set 










with deferred vol- 
ume mounting 


DEFER 

on UNIT 










with volume pre- 
mounting 








/♦SETUP 




dynamic 






DYNAMNBR 

on EXEC 







Figure 2-3 (Part 2 of 3). Tasks for Requesting Data Set Resources 
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Tasks 



TASKS FOR 
REQUESTING DATA 
SET RESOURCES 


STATEMENTS AND PARAMETERS FOR TASK | 


JCL Statements 


JES2 Statements 


JES3 Statements 


DD 


OUTPUT JCL 


Other JCL 


Processing control 












by suppressing pro- 
cessing 


DUMMY 
NULLFILE 
on DSNAME 










by postponing speci- 
fication 


DDNAME 










with checkpointing 


CHKPT 
SYSCKEOV DD 










by subsystem 


SUBSYS 
CNTL 




CNTL 
ENDCNTL 






by TCAM job or task 


QNAME 










End processing 












deallocation 


FREE 










disposition of 
data set 


DISP 

RETPD 
and EXPDT 
on LABEL 










release of unused 
direct access space 


RLSE 
on SPACE 










disposition of 
volume 


RETAIN and 
PRIVATE 
on VOLUME 











Figure 2-3 (Part 3 of 3). Tasks for Requesting Data Set Resources 
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Tasks 



TASKS FOR 
REQUESTING 
SYSOUT RESOURCES 


STATEMENTS AND PARAMETERS FOR TASK | 


JCL Statements 


JES2 Statements 


JES3 Statements 


DD 


OUTPUT JCL 


Other JCL 


Identification 












as a sysout data set 


SYSOUT 










of output class 


class 
on SYSOUT 


CLASS 


MSGCLASS 
on JOB with 
SYSOUT-* or 
CLASS = * and 
SYSOUT = (,) 






of data set on 3540 
Diskette Input/Out- 
put Unit 


DSID 










Description 












of data attributes 


DCB 










Performance control 












by queue selection 




PRTY 









Figure 2-4 (Part 1 of 4). Tasks f»r Requesting Sysoat Data Set Resources 
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Tasks 



TASKS FOR 
REQUESTING 
SYSOUT RESOURCES 


STATEMENTS AND PARAMETERS FOR TASK | 


JCL Statements 


JES2 Statements 


JESS Statements 


DD 


OUTPUT JCL 


Other JCL 


Processing control 












with additional 
parameters 


OUTPUT 
code-name 
on SYSOUT 


DEFAULT 








with other data sets 


class 
on SYSOUT 


THRESHLD 

(JES3 only) 
GROUPID 

(JES2 only) 








by external writer 


writer-name 
on SYSOUT 


WRITER 








by mode 




PRMODE 








by holding 


HOLD 

class 
on SYSOUT 


CLASS 








by suppressing out- 
put 


DUMMY 

class 
on SYSOUT 










with checkpointing 




CKPTLINE 
CKPTPAGE 
CKPTSEC 








by Print Services 
Facility (PSF) 




FORMDEF 
PAGEDEF 









Figure 2-4 (Part 2 of 4). Tasks for Requesting Sysout Data Set Resources 
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J. aSjKS 



TASKS FOR 
REQUESTING 
SYSOUT RESOURCES 


STATEMENTS AND PARAMETERS FOR TASK 






JCL Statements 


JES2 Statements 


JES3 Statements 


DD 


OUTPUT JCL 


Other JCL 


End processing 












deallocation 


FREE 










Destination control 












to local or remote 
device or to 
another node 


DEST 
class 
on SYSOUT 


DEST 
COMPACT 




/♦ROUTE PRINT 
/♦ ROUTE PUNCH 


ORG on //♦MAIN 


to another processor 










ACMAIN 

on //♦MAIN 


to internal reader 


INTRDR 

as writer-name 
on SYSOUT 




/♦EOF 
/♦DEL 
/•PURGE 

/♦SCAN 






to terminal 


TERM 











Figure 2-4 (Part 3 of 4). Tasks for Requesting Sysout Data Set Resources 
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Tasks 



TASKS FOR 
REQUESTING 
SYSOUT RESOURCES 


STATEMENTS AND PARAMETERS FOR TASK | 


JCL Statements 


JES2 Statements 


JES3 Statements 


DD 


OUTPUT JCL 


Other JCL 


Output formatting 












to any printer 


COPIES 
FCB 

form-name 
on SYSOUT 

UCS 


COPIES 
FCB 
FORMS 
LINECT 

(JES2 only) 
UCS 
CONTROL 


forms, copies, 
and linect on JOB 
JES2 accounting 
information 


COPIES, FORMS, 
and LINECT 
on /*JOBPARM 




to 3800 Printing Sub- 
system, in addition 
to most of printer 
parameters 


BURST 

CHARS 

FLASH 

MODIFY 

DCB = OPTCD = J 


BURST 

CHARS 

FLASH 

MODIFY 

TRC 




BURST 
on /*JOBPARM 




to 3211 Printer with 
indexing feature 




INDEX (JES2 
LINDEX only) 








to punch 


COPIES 

FCB 

form-name 

on SYSOUT 
DCB=FUNC=I 


COPIES 

FCB 

FORMS 








of dumps on 3800 
Printing Subsys- 
tem 


CHARS = DUMP 
FCB=STD3 


CHARS = DUMP 
FCB=STD3 








Output limiting 


OUTLIM 




lines and cards 
on JOB 

JES2 accounting 
information 


BYTES, CARDS, 
LINES, and PAGES 
on /*JOBPARM 


BYTES, CARDS, 
LINES, and PAGES 

on //*MAIN 



Figure 2-4 (Part 4 of 4). Tasks for Requesting Sysout Data Set Resources 
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Format: Fields 



Chapter 3. Format of Statements 



This chapter describes the fields in JCL, JES2 and JES3 statements. It ends with the 
conventions for continuing statements. 



JCL Statement Fields 



A JCL statement consists of one or more 80-byte records. Each record is in the form of an 
80-column punched-card image. Each JCL statement is logically divided into the following five 
fields. All five fields do not appear on every statement; see Figure 3-1 on page 3-2 for the 
fields that can appear on each statement. 

Identifier field 

The identifier field indicates to the system that a statement is a JCL statement rather than 
data. The identifier field consists of the following: 

• Columns 1 and 2 of all JCL statements, except the delimiter statement, contain // 

• Columns 1 and 2 of the dehmiter statement contain either /* or two other characters 
designated in a DLM parameter to be the dehmiter 

• Columns 1, 2, and 3 of a JCL comment statement contain //* 

Name field 

The name field identifies a particular statement so that other statements and the system 
can refer to it. For JCL statements, code the name as follows: 

• The name must begin in column 3. 

• The name is 1 through 8 alphanumeric or national characters. See Figure 4-2 on 
page 4-4 for the character sets. 

• The first character must be an alphabetic or national. 

• The name must be followed by at least one blank. 

Operation field 

The operation field specifies the type of statement, or, for the command statement, the 
command. Code the operation field as follows: 

• The operation field consists of the characters in the syntax box for the statement. 

• The operation follows the name field. 

• The operation must be preceded and followed by at least one blank. 
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Parameter field 

The parameter field contains parameters separated by commas. Code the parameter field 
as follows: 

• The parameter field follows the operation field. 

• The parameter field must be preceded and followed by at least one blank. 

See "Parameter Field" on page 3-3 for details on coding the parameter field. 

Comments field 

The comments field contains any information you deem helpful when you code the 
control statement. Code the comments field as follows: 

• The comments field follows the parameter field. 

• The comments field must be preceded by at least one blank. 

You can code comments after the parameter field even though you continue the 
parameter field on a subsequent statement; see "Continuing JCL Statements" on 
page 3-5. 

For most statements, if you do not code any parameters, do not code any comments. 



Statement 


Fields 


JCL Command 


//command [parameter] [comments] 


Comment 


//♦comments 


CNTL 


//label CNTL * [comments] 


DD 


//[ddname] DD [parameter] [comments] 
//[ddname] DD 


Delimiter 


/* [comments] 
XX [comments] 


ENDCNTL 


//[label] ENDCNTL [comments] 


EXEC 


//[stepname] EXEC parameter [comments] 


JOB 


//jobname JOB [parameter] [comments] 
//jobname JOB 


Null 


// 


OUTPUT JCL 


//name OUTPUT parameter [comments] 


PEND 


//[name] PEND [comments] 


PROC (cataloged) 


//[name] PROC [parameter] [comments] 
//[name] PROC 


PROC (in-stream) 


//name PROC [parameter] [comments] 
//name PROC 



Figure 3-1. JCL Statement Fields 

Location of Fields on Statements: Code the identifier field beginning in column 1 and the name 
field immediately after the identifier, with no intervening blanks. Code the operation, 
parameter, and comments fields in free form. Free form means that the fields need not begin in 
a particular column. Between fields leave at least one blank; the blank serves as the delimiter 
between fields. 
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Do not code fields, except on the comment statement, past column 71. If the total length of the 
fields would exceed 71 columns, continue the fields onto one or more following statements. 
Continuing fields is described under "Continuing JCL Statements" on page 3-5. The comment 
statement can be coded through column 80. 

Use Keywords Only for Parameters or Subparameters: Do not use parameter or subparameter 
keywords from any JCL, JES2, or JES3 statements as symbolic parameters, names, or labels. 



Parameter Field 



The parameter field consists of two types of parameters: positional parameters and keyword 
parameters. All positional parameters must precede all keyword parameters. Keyword 
parameters follow the positional parameters. 

Commas: Use commas to separate positional parameters, keyword parameters, and 
subparameters in the parameter field. 

Positional Parameters: A positional parameter consists of (1) characters that appear in 
uppercase in the syntax and must be coded as shown, (2) variable information, or (3) a 
combination. For example, DATA on a DD statement, programmer's-name on a JOB 
statement, and PGM - program-name on an EXEC statement. 

Code positional parameters first in the parameter field in the order shown in the syntax. If you 
omit a positional parameter and code a following positional parameter, code a comma to 
indicate the omitted parameter. Do not code the replacing comma if: 

• The omitted positional parameter is the last positional parameter. 

• All following positional parameters are also omitted. 

• Only keyword parameters follow. 

• All positional parameters are omitted. 

Keyword Parameters: A keyword consists of characters that appear in uppercase in the syntax 
and must be coded as shown followed by an equals sign followed by either characters that must 
be coded as shown or variable information. For example, RD = R and 
MSGCLASS = class-name on the JOB statement. 

Code any of the keyword parameters for a statement in any order in the parameter field after 
the positional parameters. Because of this positional independence, never code a comma to 
indicate the absence of a keyword parameter. 

Multiple Subparameters: A positional parameter or the variable information in a keyword 
parameter sometimes consists of more than one item, called a subparameter list. A 
subparameter Ust can consist of both positional and keyword subparameters. These 
subparameters follow the same rules as positional and keyword parameters. 

When a parameter contains more than one subparameter, separate the subparameters by 
commas and enclose the subparameter list in parentheses or, if indicated in the syntax, by 
apostrophes. If the list is a single keyword subparameter or a single positional subparameter 
with no omitted preceding subparameters, omit the parentheses or apostrophes. 



Chapter 3. Format of Statements 3-3 



Format: Fields 



JES2 Control Statement Fields 

The rules for coding JES2 control statements are the same as the rules for JCL statements, with 
the following additions: 

• Columns 1 and 2 always contain the characters /* 

• Do not code comments on any JES2 statements. Where comments are needed, code a JCL 
comment statement. 

• If you code the same parameter on the same statement more than once, JES2 uses the value 
in the last parameter. 

When coding a JES2 control statement more than once, be aware of the following JES2 actions: 

• If the same parameter appears on more than one statement, JES2 uses the value coded on 
the last statement. 

• If the statements contain different parameters, JES2 uses all parameters combined. 



JES3 Control Statement Fields 

The rules for coding JES3 control statements are the same as the rules for JCL statements, with 
the following additions: 

• Columns 1 , 2, and 3 contain the characters //* except for two JES3 control statements that 
contain /* in columns 1 and 2. 

• Columns 3 and 4 must not be blank. 

• Do not code comments on JES3 control statements, except //*ENDPROCESS and 
//*PAUSE statements. Where additional comments are needed, code a JCL comment 
statement. 
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Continuing Statements 

Continuing JCL Statements 

When the total length of the fields on a control statement exceeds 71 columns, continue the 
fields onto one or more following statements. 

JCL statements that you cannot continue follow. While you cannot continue these statements, 
you can code as many separate statements as you need. 

Command statement 
Comment statement 
Delimiter statement 
Null statement 

For all other JCL statements, you can continue the parameter field or the comments field. 

Continuing the Parameter Field: 

1 . Interrupt the field after a complete parameter or subparameter, including the comma that 
follows it, at or before column 71. 

2. Include comments by following the interrupted parameter field with at least one blank. 

3. Code a nonblank character in column 72 when you are continuing a comments field and, 
optionally, when you are continuing the parameter field. 

Note: The system treats a following statement as a continuation, even when column 72 is 
blank, when conventions 4, 5, and 6 are followed. 

4. Code // in columns 1 and 2 of the following statement. 

5. Continue the interrupted parameter or field beginning in any column from 4 through 16. If 
you begin coding after column 16, the system treats this statement as a comment field. 

6. Column 3 of the following statement can contain only a blank or an asterisk. If column 3 
contains anything else, the system assumes the following statement is a new statement. The 
system issues an error message indicating that no continuation is found and fails the job. 

Continuing the Comments Field: 

1. Interrupt the comment at a convenient place before column 72. 

2. Code a nonblank character in column 72. 

3. Code // in columns I and 2 of the following statement. 

4. Continue the comments field beginning in any column after column 3. 

You can also use a comments statement to include continued comments. 
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Examples of Continued Statements: 



//DSl DD DSNAME=INDS,DISP=OLD,CHKPT=EOV, MY INPUT DATA SET 
// UNIT=SYSSQ , VOLUME=SER= ( TAPED 1 , TAPE02 , TAPE03 ) 



//DDl DD DSNAME=SWITCH.LEVEL18.GROUP12,UNIT=3350, 
// VOLUME=335023,SPACE=(TRK, (80,15) ) ,DISP=( ,PASS) 



//STP4 EXEC PROC=BILLING , COND . PAID= ( ( 20 , LT ) , EVEN ) , 

// COND . LATE= ( 60 , GT , FIND ) , 

// COND . BILL= ( ( 20 , GE ) , ( 30 , LT , CHGE ) ) THIS STATEMENT CALLS 

// THE BILLING PROCEDURE AND SPECIFIES RETURN CODE TESTS 

//* FOR THREE PROCEDURE STEPS. 

This example shows continuation of comments, first, according to the four rules above and, 
then, onto a comments statement. 



Continuing JES2 Control Statements 

The only JES2 control statement that you can continue is the /*OUTPUT statement. For all 
other JES2 control statements, code the statement as many times as needed. 

Continuing JES3 Control Statements 

Continue JES3 statements, except the command statement or //*NETACCT statement, by: 

1 . Coding a comma as the last character of the first statement. 

2. Coding //* in columns 1 through 3 of the continuation statement. 

3. Resuming the code in column 4 of the continuation statement. 

On the JES3 //*NET statement, each parameter must appear entirely on one statement; a 
subparameter cannot be continued after a comma, except for the RELEASE parameter. To 
continue the RELEASE parameter, end the statement with the comma following a jobname and 
continue the next statement with the next jobname. The left parenthesis appears at the 
beginning of the jobname list and the right parenthesis appears at the end of the list. For 
example: 

//*NET NETID=EXP1 , RELEASE= ( JOB35 , JOB27Z ,MY JOB , 
WRITJB, JOBABC) 

If the parameters on a //*NETACCT statement cannot fit on one statement, code more than 

one //*NETACCT statement. 
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Chapter 4. Syntax of Parameters 



Syntax rules define how to code the fields and parameters on job control statements. The 
syntax indicates: 

• What the system requires. 

• What is optional for the specific purpose or process you are requesting. 

• How the parameters are to appear. 

The syntax rules apply to all job control statements: JCL statements, JES2 control statements, 
and JES3 control statements. 

You must follow the syntax rules in coding job control statements to achieve specific results. If 
you do not follow the rules, you may get error messages or unpredictable results. IBM does not 
support the use of statements or parameters to achieve results other than those stated in this 
publication. 



Notation Used to Show Syntax 



The syntax of the job control statements and of their parameters appear in the chapters that 
describe the statements. The notation used in this publication for the syntax is shown in 
Figure 4-1 on page 4-2. 
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Notation 


Meaning 


Examples 


Uppercase letters, words, 
and characters 


Code uppercase letters, words, and the following 
characters exactly as they appear in the syntax. 

& ampersand 
* asterisk 
, comma 
= equal sign 
( ) parentheses 
period 




Lowercase letters, words, 
and symbols 


Lowercase letters, words, and symbols in the syntax 
represent variables. Substitute specific information 
for them. 


Syntax: on JOB statement 
CLASS = jobname 

Coded: 
CLASS = A 


1 (vertical bar) 


A vertical bar indicates an exclusive OR. Never code 
1 on a control statement. It is used between choices 
within braces or brackets; it indicates that you code 
only one of the items within the braces or brackets. 


Syntax: on DD DCB parameter 
BFALN = {F|D} 

Coded: 
BFALN = F 

or 
BFALN = D 


{ } (braces) 


Braces surround required, related items and indicate 
that you must code one of the enclosed items. 
Never code { or } on a control statement. 


Syntax: on DD SPACE parameter 
(TRK ] 
CYL 
blklgthl 

Coded: 
TRK 
CYL 
960 


[ ] (brackets) 


Brackets surround an optional item or items and 
indicate that you can code one or none of the 
enclosed items. Never code [ or ] on a control 
statement. 


Syntax: on DD UNIT parameter 
[,DEFER] 

Coded: 
,DEFER 

or 
omitted 

Syntax: on DD LABEL parameter 
r,RETPD = nnnn 1 

[,EXPDT = yydddJ 

Coded: 
,EXPDT = yyddd 

or 
,RETPD = nnnn 

or 
omitted 



Figure 4-1 (Part 1 of 2). Notation Used to Show Syntax 
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Notation 


Meaning 


Examples 


{ , } or [ , ] 


One of the items in braces or brackets can be a 
comma. Code the comma when you do not code 
any of the other items in the braces or brackets but 
you are coding a following part of the parameter. 


Syntax: on DD UCS parameter 
UCS = (character-set-code[,FOLD|,] 
[,VERIFY]) 

Coded: 
UCS = (character-set-code) 
UCS = (character-set-code,FOLD) 
UCS = (character-set-code,FOLD, VERIFY) 
UCS = (character-set-code,, VERIFY) 

Note that the comma is not coded if both 
FOLD and VERIFY are omitted, but must 
appear if FOLD is omitted and VERIFY 
follows. 


j (underline) 


An underline indicates the default that the system 
uses when you do not code a subparameter. 


Syntax: on JOB or EXEC statement 
ADDRSPC = (VIRTIREALI 


Coded: 
ADDRSPC omitted means 
ADDRSPC = VIRT 


... (ellipsis) 


An ellipsis follows an item that you can code more 
than once. Never code ... on a control statement. 


Syntax: on DD statement 
COND = ((code,operator)[,(code,operator)]....) 

Coded: 
Can repeat ,(code,operator) 
Thus: 
COND = ((12,GE),(8,EQ),(4,EQ)) 


.. (two consecutive 
periods) 


Two consecutive periods indicate that a parameter 
consists of a symbolic parameter followed by a 
period and then by other code, so that only part of 
the parameter is variable. 


Coded: 
&DEPT..NYC 

Meaning: 
If&DEPTisD27: 

D27.NYC is the value 



Figure 4-1 (Part 2 of 2). Notation Used to Show Syntax 



Chapter 4. Syntax of Parameters 4-3 



Syntax: Character Sets 



Character Sets 



To code job control statements, use characters from the three character sets in Figure 4-2. 
Figure 4-3 hsts the special characters that have syntactical functions in job control statements. 



Character Set 


Contents 


Alphanumeric 


Alphabetic 
Numeric 


Capital A through Z 
through 9 


National 
(See note) 


"At" sign 
Dollar sign 
Pound sign 


. @ 
$ 
# 


Special 


Comma 

Period 

Slash 

Apostrophe 

Left parenthesis 

Right parenthesis 

Asterisk 

Ampersand 

Plus sign 

Hyphen 

Equal sign 

Blank 


/ 

( 

) 

* 

& 

+ 


Note: The system recognizes the following hexadecimal representations of the U.S. National 
characters; @ as X'7C'; $ as X'5B'; and # as X'7B'. In countries other than the U.S., the 
U.S. National characters represented on terminal keyboards might generate a different 
hexadecimal representation and cause an error. For example, in some countries the $ 
character may generate a X'4A'. 



Figure 4-2. Character Sets 



Character 


Syntactical Function 


() 
& 
&& 

* 
(blank) 


To separate parameters and subparameters 

To separate a keyword from its value, for example, BURST = YES 

To enclose a parameter or subparameter list 

To identify a symbolic parameter, for example, &LIB 

To identify a temporary data set name, for example, &&TEMPDS 

To separate parts of a qualified data set name, for example, 

A. B.C., or parts of certain parameters or subparameters, for 

example, nodename.userid 

To refer to an earlier statement, for example, OUTPUT = *.name, 

or, in certain statements, to indicate special functions: 

//label CNTL * 

//ddname DD * 

RESTART = * on the JOB statement 
To delimit fields 



Figure 4-3. Special Ciiaracters Used in Syntax 
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Special Characters in Parameters: The syntax or parameter description indicates if the variable 
that you code can contain special characters or not. Parameters and subparameters that can 
contain special characters not used for syntactical functions usually must be enclosed in 
apostrophes, for example, ACCT = '123 + 456'. Code each apostrophe that is part of the 
parameter or subparameter as two consecutive apostrophes, for example, code O'Neil as 
O'NEIL'. 

Warning: A blank can be coded only in the following: 

Accounting information on the JOB statement 
Programmer's name on the JOB statement 
PARM subparameter on the EXEC statement 

When so used, the parameter or subparameter must be enclosed in apostrophes. In any other 
parameter, even though enclosed in apostrophes, a blank is interpreted as the end of the parameter 
field; the system regards anything that follows as comments. 

Figure 4-4 lists the parameters that can contain certain special characters without requiring 
enclosing apostrophes. 



Statement and Param- 
eter or Subparameter 


Special Characters Not Needing 
Enclosing Apostrophes 


Examples 


JOB accounting 
information 


Hyphens (-) 


//JOBA JOB D58-D04 


JOB programmer's-name 


Hyphens (-), leading periods, or 
embedded periods. Note that 
a trailing period requires 
enclosing apostrophes. 


//JOBB JOB ,S-M-TU 
//JOBC JOB ,.ABC 
//JOBD JOB ,P.F.M 
//JOBE JOB ,'A.B.C/ 


EXEC ACCT 


Hyphens (-) or plus zero ( + 0, an 
overpunch) 


//S 1 EXEC PGM = A, ACCT = D58-LOC 
//S2 EXEC PGM = B,ACCT = D04 + 


DD DSNAME 


Hyphens (-) 


DSNAME = A-B-C 




Periods to indicate a qualified data set 


DSNAME = A.B.C 




name 






Double ampersands to identify a 
temporary data set name 


DSNAME = &&TEMPDS 




Parentheses to enclose the member 
name of a partitioned data set, the 
area name of an indexed sequential 
data set, or the generation number 
of a generation data set 


DSNAME = PDS 1 (MEM A) 
DSNAME = ISDS(PRIME) 
DSNAME = GDS(+1) 




Plus ( + ) or minus (-) sign to identify 
a generation of a generation data 
group 


DSNAME = GDS(-2) 


DD VOLUME = SER 


Hyphens (-) 


VOLUME = SER = PUB-RD 


DD UNIT device-type 


Hyphens (-) 


UNIT = 3330-1 



Figure 4-4. Special Characters that Do Not Require Enclo^^ing Apostrophes 
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Backward References 

Many parameters in job control statements can use a backward reference to fill in information. 
A backward reference is a reference to an earlier statement in the job or in a cataloged or 
in-stream procedure called by a job step. A backward reference is in the form: 

*.name or *.ddname where name or ddname is the name field of the referenced statement. 

*.stepnaine.naine or *.stepname.ddname where the referenced statement, name or ddname, is 
in an earlier step, stepname, in the same job. 

*.stepname.procstepnaine.name or *.stepnaine.procstepname.ddname where this job step or an 
eariier job step, stepname, calls a procedure; the procedure contains procedure step, 
procstepname, which contains the referenced statement, name or ddname. 

The backward reference lets you copy previously coded information or refer to an eariier 
statement. The following parameters can make backward references: 

• DD CNTL refers to earlier CNTL statement 

• DD DCB refers to earlier DD statement to copy its DCB parameter 

• DD DSNAME refers to eariier DD statement to copy its DSNAME parameter, whether or 
not the data set is a partitioned data set, and whether or not the data set is a temporary 
data set 

• DD OUTPUT refers to eariier OUTPUT JCL statement 

• DD VOLUME = REF refers to eariier DD statement to use the same volume(s). The 
LABEL label type subparameter is also copied from the referenced DD statement. 

• EXEC PGM refers to an earlier DD statement that defines the program to be executed as a 
member of a partitioned data set 

The following statements cannot be referenced: 

• DD * statement in DCB, DSNAME, or VOLUME parameter 

• DD DATA statement in DCB, DSNAME, or VOLUME parameter 

• DD DUMMY statement in VOLUME or UNIT parameter. The referring DD statement 
acquires a dummy status. 

• DD DYNAM statement 

• DD statement containing FREE = CLOSE in VOLUME or UNIT parameters 

• Sysout DD statement 
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Examples of Backward References: 

//JOBl JOB 

//STEPA EXEC . . . 

//DDl DD DSNAME=REPORT 

//DD4 DD DSNAME=*.DD1 

The referring and referenced DD statements are in the same step. 

//J0B2 JOB 

//STEPl EXEC . . . 

//DDA DD DSNAME=D58.POK.PUBS01 

//STEP2 EXEC . . . 

//DDB DD DSNAME=*. STEPl. DDA 

The referring and referenced DD statements are in different steps in the same job. 
Cataloged procedure PROCl contains: 

//PSl EXEC . . . 

//PSTEPl EXEC . . . 

//DSl DD DSNAME=DATA1 

//PSTEP2 EXEC . . . 

//DS2 DD DSNAME=DATA2 



The job contains: 

//JOBS JOB 

//CALLER EXEC PR0C=PR0C1 

//REFl DD DSNAME=*. CALLER. PSTEP2.DS2 

//NEXT EXEC . . . 

//REF2 DD DSNAME=*. CALLER. PSTEPl. DSl 



DD statement REFl in the calling step refers to DD statement DS2 in procedure step PSTEP2. 
DD statement REF2 in a step after the calUng step refers to DD statement DSl in procedure 
step PSTEPl. Note that the entire procedure is processed when the calling EXEC statement is 
processed; therefore, all DD statements in the procedure are earlier than all DD statements in 
the calUng step. 
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Chapter 5. Cataloged and In-Stream Procedures 



For jobs that you run frequently or types of jobs that use the same job control, prepare sets of 
job control statements, called procedures. Place a procedure in an input stream, where it is 
called an in-stream procedure, and execute it to test it. Then place, or catalog, it in the system 
procedure hbrary, SYSl.PROCLIB, where it is called a cataloged procedure. 

Procedure Statements: A cataloged procedure consists of EXEC, DD, OUTPUT JCL, CNTL, 
ENDCNTL, and JCL comment statements and, optionally, may begin with a PROC statement. 
An in-stream procedure consists of the same statements and must begin with a PROC statement 
and end with a PEND statement. 

Note: Do not place any other JCL statements or any JES2 or JES3 control statements in a 
procedure. Do not place an in-stream data set, which begins with DD * or DD DATA, in a 
procedure. 

Using a Procedure: To execute a procedure, call it on an EXEC statement in an in-stream job. 
On the EXEC statement, specify the name of the procedure in a PROC parameter. The step 
uses the JCL statements in the procedure as if the JCL statements appeared in the input stream 
immediately following the EXEC statement. If necessary, you can modify the procedure for the 
current execution of the job step. 

If the called procedure is cataloged, the system retrieves it from SYSl.PROCLIB unless one of 
the following is specified: 

• In a JES2 system, a PROCLIB parameter on a JES2 /*JOBPARM statement. 

• In a JES3 system, a library name in a PROC parameter on a JES3 //*MAIN statement. 

Testing a Procedure: Before putting a procedure into the procedure library, you should test it. 
For testing, place a PROC statement before the procedure and a PEND statement after it and 
place it in an input stream. For the test, call this procedure with an EXEC statement that 
appears later in the same job. After testing the procedure, catalog it; then call it with an 
EXEC statement whenever you want to use it. 

Note: The maximum number of in-stream procedures you can code in any job is 15. Each of 
these 15 procedures can be called more than once. 

Cataloged and in-stream procedures are not checked for correct syntax until an EXEC 
statement that calls the procedure is checked for syntax. Therefore, a procedure can be tested 
only if an EXEC statement calls it. For the test, no statements should be modified. 
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Cataloging a Procedure: The library containing cataloged procedures is a partitioned data set. 
The system procedure library is SYSl.PROCLIB. The installation can have many more 
procedure libraries with different names. When a cataloged procedure is called, the calling step 
receives a copy of the procedure; therefore, a cataloged procedure can be used simultaneously 
by more than one job. 

Use the lEBUPDTE utility program to add a procedure to a library or to modify permanently 
a procedure in a catalog. If modifying, tell the system operator to delay any jobs that would 
use the procedure during modification. 

In a JES3 system, you can specify UPDATE on the JES3 //*MAIN statement to update a 
procedure library. 

The name of a cataloged procedure is its member name or ahas in the library. 



Modifying Procedures 

For its current execution, you can modify an in-stream or cataloged procedure by: 

• Overriding, nullifying, or adding EXEC statement parameters 

• Overriding, nullifying, or adding parameters to DD or OUTPUT JCL statements 

• Adding DD or OUTPUT JCL statements 

Invahd parameters in a procedure cannot be corrected through modification. Before making 
modifications, the system scans the original procedure statements for errors and issues error 
messages. 

Modifying EXEC Statement Parameters 

All keyword parameters on the calling EXEC statement affect the execution of the procedure, 
as follows: 

• AU procedure statements: If a keyword parameter is to override the parameter or be added 
to every EXEC statement in the procedure, code the parameter in the usual way. For 
example, the ACCT parameter applies to all steps: 

//STEPl EXEC PROC=RPT,ACCT=5670 

Note: A PARM parameter without a procstepname qualifier applies only to the first 
procedure step. A TIME parameter without a procstepname qualifier applies to the entire 
procedure and nullifies any TIME parameters on procedure step EXEC statements. 

If the keyword parameter is to nullify the parameter on every EXEC statement in the 
procedure, code it without a value following the equal sign. For example, the ACCT 
parameter is nullified in all steps: 

//STEP2 EXEC PROC=RPT,ACCT= 
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• Only one procedure statement: If the keyword parameter is to override the parameter or be 
added to only one EXEC statement in the procedure, code .procstepname immediately 
following the keyword. The procstepname is the name field of the procedure EXEC 
statement containing the keyword parameter to be overridden. For example, the ACCT 
parameter applies to only step PSTEPWED: 

//STEPl EXEC PROC=RPT,ACCT.PSTEPWED=5670 

If the keyword parameter is to nuUify the parameter on only one EXEC statement in the 
procedure, code it with the procstepname. For example: 

//STEP2 EXEC PROC=RPT,ACCT.PSTEPTUE= 

The override, nullifying, or addition apphes only to the current execution of the job step; the 
procedure itself is not changed. 

Rules for Coding Modifying EXEC Parameters: 

• A PGM parameter cannot be modified. 

• The calling EXEC statement can contain more than one change. 

• Modifying parameters should appear in the following order: 

- Parameters without a procstepname quahfier. 

- All parameters modifying the first step, then the second step, then the third step, etc. 

• The parameters for each step do not need to be coded in the same order as they appear on 
the procedure EXEC statement. 

• An entire overriding parameter must be coded, even though only part of the overridden 
parameter is being changed. 

Modifying OUTPUT JCL and DD Statements 

OUTPUT JCL and DD statements following the calling EXEC statement (1) override, nullify, 
or add parameters to OUTPUT JCL and DD statements in the procedure or (2) are added to 
the procedure. These changes affect only the current execution of the job step; the procedure 
itself is not changed. When an OUTPUT JCL statement is modified, the sysout data set is 
processed according to the parameters as modified by the overriding statement. 

Location in the JCL: Place the modifying statements in the following order after the EXEC 
statement that calls the procedure: 

• OUTPUT JCL statements that override, nullify, or add parameters to OUTPUT JCL 
statements in the procedure. These statements must be in the same order as the procedure 
OUTPUT JCL statements they override. 

• OUTPUT JCL statements that are added to the procedure. 

• DD statements that override, nullify, or add parameters to DD statements in the procedure. 
These statements must be in the same order as the procedure DD statements they override. 
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• DD statements that are added to the procedure. 

• In-stream data sets. 

Coding an Overriding OUTPUT JCL or DD Statement: To override, nullify, or add parameters 
to a procedure OUTPUT JCL or DD statement, code in the name field of the overriding 
OUTPUT JCL or DD statement the name of the procedure step containing the overridden 
statement, followed by a period, followed by the name of the procedure OUTPUT JCL 
statement or the ddname of the procedure DD statement. 

//pstepname .name OUTPUT parameters 
//p step name .ddname DD parameters 

Rules for Modifying OUTPUT JCL or DD Parameters: 

• The overriding statement can contain more than one change. 

• Modifying parameters can appear in any order. 

• To nullify a parameter, do not code a value after the equal sign. 

• If you are adding a parameter that is mutually exclusive with a parameter on the procedure 
statement, the procedure parameter is automatically nullified. 

• An entire overriding parameter must be coded, even though only part of the overridden 
parameter is being changed. 

Rules for Modifying DD Parameters: 

• To nulHfy all parameters but the DCB parameter, code DUMMY on the overriding DD 
statement. 

• Special rules apply when overriding a DCB parameter: 

— Code only the keyword subparameters to be changed; the other DCB subparameters 
remain unchanged. 

— If a positional subparameter is needed, code it, regardless of whether it appears in the 
overridden DCB parameter. If a positional subparameter is not needed or is to be 
nullified, omit it from the overriding DCB parameter. 

— To nullify the entire DCB parameter, nullify each subparameter appearing in the 
overridden DCB parameter. 

• To nullify a DUMMY parameter on the procedure statement, code a DSNAME parameter 
on the overriding DD statement and assign a name other than NULLFILE. 

Coding an Added OUTPUT JCL or DD Statement: To add OUTPUT JCL or DD statements 
to a procedure step, code in the name field of the added OUTPUT JCL or DD statement the 
name of the procedure step, followed by a period, followed by a name or ddname. The name 
must not appear on any procedure statement. 

//pstepname. name OUTPUT parameters 
//pstepname. ddname DD parameters 
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If you omit the procedure step name, the statement is added to the step named in the previous 
OUTPUT JCL or DD statement that named a step. If no previous statements named steps, the 
statement is added to the first step in the procedure. 

Added OUTPUT JCL and DD statements can contain symbolic parameters. If the statement is 
being added to the last procedure step, any symbolic parameters it contains must appear 
elsewhere in the procedure. 

Instream Data for a Procedure: To supply a procedure step with data from the input stream, 
code a DD * or DD DATA statement in the calling step after the last overriding and added 
DD statement. The name field of this statement must contain the name of the procedure step, 
followed by a period, followed by a ddname. The ddname can be of your choosing or 
predefined in the procedure. If it is predefined, it appears in a DDNAME parameter on a 
procedure DD statement. For example: 

//PROCSTPl.ANYNAME DD * 
//PR0CSTP2.PREDEFN DD DATA 

Rules for Modifying DD Statements in Concatenated Data Sets: 

• To override the first DD statement in a concatenation, code only one overriding DD 
statement. 

• To override any following DD statements in the concatenation, code an overriding DD 
statement for each concatenated DD statement. 

• The overriding DD statements must be in the same order as the concatenated DD 
statements. 

• Code a ddname on only the first overriding DD statement. Leave the ddname field blank 
on the following statements. 

• To leave a concatenated statement unchanged, code its corresponding overriding DD 
statement with a blank operand field. 
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Examples of Procedures 



In the input stream: 

//JOBA JOB ACCT23,'G, 
//STEPA EXEC PROC=REP 
//PSTEPl.INDS DD * 

(data) 



HILL' 



In SYSl.PROCLIB member REP: 

// PROC 

//PSTEPl EXEC PGM=WRIT22 

//OUTDS DD SYSOUT=A 

In this example, the EXEC statement STEPA calls the cataloged procedure named REP and 
supplies in-stream data. The procedure executes a program named WRIT22. The output from 
the program will appear in the sysout class A data set. 

In the input stream: 



//JOBl 


JOB 


, 'H.H. MORRILL' 


//ADDl 


OUTPUT 


C0PIES=2 


//STEPA 


EXEC 


PROC=P 


//PSl.OUTA 


OUTPUT 


CONTROL=DOUBLE , C0PIES=5 


//PS2.0UTB 


OUTPUT 


DEFAULT=YES , DEST=STL 


//PSl.DSB 


DD 


0UTPUT=*.ADD1 


//PSl.DSE 


DD 


* 



(data) 



In SYSl.PROCLIB member P: 



//PSl 


EXEC 


PGM=R15 


//OUTA 


OUTPUT 


CONTROL=PROGRAM 


//DSA 


DD 


SYSOUT=C , OUTPUT=* . OUTA 


//DSB 


DD 


SYSOUT=D , OUTPUT=* . OUTA 


//PS2 


EXEC 


PGM=T48 


//DSC 


DD 


SYSOUT=A 



In this example, added statements are: 

• ADDl, which is an OUTPUT JCL statement added at the job level. 

• PS2.0UTB, which is a default OUTPUT JCL statement added to procedure step PS2. 

• PSl.DSE, which is an in-stream data set added to procedure step PSl. 

Overriding statements are: 

• PSl.OUTA, which changes the CONTROL parameter and adds a COPIES parameter to 
OUTPUT statement OUTA in procedure step PSl. 

• PSl.DSB, which changes the OUTPUT parameter on DD statement DSB in procedure step 
PSl. 
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//JOBB 
//SYSCK 

// 

//STEPB 

//PSTEPl.DDl 

//PSTEP2.DD3 

//PSTEP3.DD5 

//PSTEP3.DD6 



//PSTEPl.INDS DD 



JOB ACCT23,'G. HILL' 

DD DSNAME=CHECKPTS,DISP=( NEW, KEEP, KEEP) , 

UNIT=3420 

EXEC PROC=WRIT35,COND.PSTEP3=(4,GT,PSTEPl) ,RD=R 

DD VOLUME=SER= , UNIT=S YSDA , DISP= ( NEW , CATALG ) 

DD DISP=( OLD, KEEP) 

DD DUMMY 

DD DSNAME=A.B.C 
* 



(data) 



In SYSl.PROCLIB member WRIT35: 

// PROC 

//PSTEPl EXEC PGM=WT1,TIME=( ,50) 

//DDl DD DSNAME=DATA1, DISP=( NEW, DELETE ) ,SPACE=(TRK, (10,2) ) , 

// UNIT=3330,VOL=SER=1095 

//DD2 DD DSNAME=&&WORK,UNIT=SYSDA,SPACE=(CYL, (10,1) ) , 

// DISP=(,PASS) 

//PSTEP2 EXEC PGM=WT2,TIME=(,30) 

//DD3 DD DSNAME=*.PSTEP1.DD2,DISP=( OLD, DELETE) 

//PSTEP3 EXEC PGM=UPDT,TIME=(,45) ,RD=RNC 

//DD4 DD SYSOUT=* 

//DD5 DD DSNAME=DATA3,UNIT=3340,DISP=OLD, 

// VOLUME=SER=335006 

//DD6 DD DSNAME=QOUT,UNIT=3400-5 

//DD7 DD SYSOUT=H 

In this example, EXEC statement STEPB calls the cataloged procedure WRIT35. The COND 
parameter is added to the EXEC statement for PSTEP3. The RD parameter is added to the 
EXEC statements for PSTEPl and PSTEP2 and overrides the RD parameter on the EXEC 
statement for PSTEP3. Because an RD = R parameter requires a SYSCK DD statement in the 
job, a SYSCK DD statement was placed following the JOB statement in the input stream. 

In-stream DD statement PSTEPl.DDl modifies DD statement DDl in PSTEPl; it nuUifies the 
VOLUME = SER parameter and overrides the UNIT and DISP parameters. Note that the 
parameters are not in the same order in the overriding and overridden statements. 

In-stream DD statement PSTEP2.DD3 modifies DD statement DD3 in PSTEP2; it overrides 
the DISP parameter. Note that the entire parameter is coded, even though only the second 
subparameter is being changed. 

In-stream DD statement PSTEP3.DD5 nullifies DD statement DD5 in PSTEP3. However, DD 
statement DD5 will be checked for correct syntax. 

In-stream DD statement PSTEP3.DD6 modifies DD statement DD6 in PSTEP3; it overrides 
the DSNAME parameter. 

In-stream DD statement PSTEPl.INDS is added to PSTEPl, supplying in-stream data to be 
read by program DATAl. 

Note that procedure DD statements DD2, DD4, and DD7 were not modified. 
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Symbolic Parameters 

In order to be modified easily, statements in cataloged and in-stream procedures can contain 
symbolic parameters. A symbolic parameter can stand as a symbol for a parameter, a 
subparameter, or a value, that is, for any information in the parameter field of a procedure 
statement. 

Purpose of Symbolic Parameters: Any parameter, subparameter, or value in a procedure that 
can vary each time the procedure is called is a good candidate to be coded as a symbolic 
parameter. For example, if a job step is charged to different account numbers each time the 
procedure is executed, code the ACCT parameter on the EXEC statement as one or more 
symbolic parameters. For example: 

ACCT=&ALLNOS 
ACCT=&FIRST&SECOND&THIRD 

Coding Symbolic Parameters 

Where: Code symbolic parameters on statements in a cataloged or in-stream procedure. You 
can also code symbolic parameters on DD statements being added to a procedure. However, 
on a DD statement being added to the last step of a procedure, do not use symbolic parameters 
that are not used previously in the procedure. 

Syntax: A symbolic parameter consists of an ampersand (&) followed by a name, which is 1 
through 7 alphanumeric and national characters. The first character must be alphabetic or 
national. For example, DEST = &LOC on a DD or OUTPUT JCL statement. 

Words Prohibited as Names in Symbolic Parameters: EXEC statement parameter and 
subparameter keywords cannot be used as the name in a symbolic parameter. For example, do 
not code &REGION = 200K or REGION = &REGION; correctly code REGION = &SIZE. 

In a procedure started by a START command from the operator console, do not use as 
symbolic parameters: 

DD statement keywords 

AFF 

SEP 

SPLIT 

SUBALLOC 

Symbolic Parameters Enclosed in Apostrophes: If a symbolic parameter is enclosed in 
apostrophes, correct substitution will occur only if the enclosed symbolic parameter is 
immediately preceded by a symbolic parameter that is not enclosed in apostrophes. For 
example, both A and B will be substituted correctly in DSNAME - &A'B'. 

Symbolic Parameter before Fixed Code: A period is required after a symbolic parameter wlien 
the following code does not vary and begins with: 

• An alphanumeric or national character 

• A period 

The system recognizes the period as a delimiter: the period does not appear after the symbolic 
parameter is assigned a value or nullified. 
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For example, if the first part of the data set name varies and the last does not, MONDATA, 
TUESDATA, etc., code: 

DSNAME=&DAY . DATA 

Code two consecutive periods (..) if a period should follow the symbolic parameter. For 
example, code &DEPT..POK when the desired value is D58.POK and DEPT = D58 is the value 
assignment. 

Symbolic Parameter for Positional Parameter: When a symbohc parameter is a positional 
parameter followed by other parameters in the statement, the symbolic parameter should be 
followed by a period instead of a comma. For example: 

//DSl DD &POSPARM.DSNAME=ATLAS,DISP=OLD 

If &POSPARM is nullified, the statement appears as: 

//DSl DD DSNAME=ATLAS,DISP=OLD 

When assigning a value to &POSPARM, include the comma: 

POSPARM= ' DUMMY , ' 

Symbolic Parameter after Fixed Code: When a symbolic parameter is placed after information 
that does not vary, the system recognizes the symbohc parameter when it encounters the 
ampersand. For example: 

DSNAME=LIB,RARY ( &MEMBER ) 
DSNAME=USERLIB . &LEVEL 

Two or More Symbolic Parameters: Code two or more symbolic parameters in succession 
without including a comma. For example: 

PARM=&DECK&CODE . 

If the value should contain a comma, include a comma in the value assigned to the symbolic 
parameter. 

Multiple Symbolic Parameters: The same symbolic parameter can appear more than once in a 
procedure, as long as the value assigned to the symbolic parameter is the same throughout the 
procedure. Therefore, &DEPT can appear several times in a procedure, if the department 
number is always to be the same. 

Uniform Symbolic Names in an Installation: The names for symbolic parameters should be 
consistent in all the cataloged and in-stream procedures at an installation. For example, every 
time a department number is to be assigned to a symbohc parameter in any procedure in the 
installation, the symbolic parameter could be named &DEPT. Different procedures could 
contain ACCT = (43877,&DEPT) and DSNAME = LIBRARY.&DEPT.TALLY. The 
installation can tell all programmers the meaning of all the "standard" symbohc names. 
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Assigning Values to and Nullifying Symbolic Parameters 

For each use of a procedure, all symbolic parameters must be assigned a value or be nullified. 
Any not assigned a value or nullified remain as coded in the JCL and may cause errors when 
the procedure is executed. To assign a value to or nullify a symbolic parameter, code the value 
on one or both of the following: 

® The EXEC statement that calls the procedure. All symbolic parameters on the EXEC 
statement must appear in the procedure. 

• The PROC statement that must begin an in-stream procedure and can begin a cataloged 
procedure. 

The symbolic parameters can be coded in any order on the PROC and EXEC statements. 

Multiple Values: If a value is assigned and/or nullified on both statements, the value on the 
EXEC statement overrides the value on the PROC statement. 

Only one value can be assigned to each symboHc parameter used in a procedure; if you assign 
or nullify the value of a symbolic parameter more than once, only the first value is used and 
that value is substituted wherever the symbolic parameter occurs. 

Assigning Default Values to Symbolic Parameters: On the PROC statement, you should assign 
default values to all symbolic parameters in a procedure. The default will be used if a value is 
not assigned on the calling EXEC statement. 

Assigning a Value to a Symbolic Parameter 

To assign a value to symbolic parameter, code: 

symbolic-par ameter=value 

Do not code the ampersand that identifies the symbolic parameter in the procedure. 

For example, if the symbolic parameter UNIT = &NUMBER appears on a DD statement in the 
procedure, code NUMBER == value on the PROC or EXEC statement. 

Length of Assigned Value: The value cannot be continued onto another statement. 

The length of the value you assign, combined with the length of all parameters and delimiters in 
the parameter field of the single procedure statement containing the symbolic parameter, cannot 
exceed 120 characters. For example, if a procedure contains: 

//DDl DD DSNAME=&A,DISP=( ,PASS) ,UNIT=3350, 

// VOLUME=SER=25143,SPACE=(CYL, (10,10) ,,CONTIG) 

The value assigned to &A must not be longer than 96 characters because the rest of the 
parameter field on that statement is 24 characters. Note that the length of the parameter field 
on the continuation statement is not considered. 

Special Characters in the Assigned Value: If the value contains special characters, enclose the 
value in apostrophes. The enclosing apostrophes are not considered part of the value. If the 
special characters include apostrophes, code each apostrophe as two consecutive apostrophes. 
For example, LOC = '0"HARE'. 
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Nullifying a Symbolic Parameter 

To nullify a symbolic parameter, code: 

symbolic parameter= 

Do not code the ampersand that identifies the symbolic parameter in the procedure. Do not code a 
value after the equal sign. Do not code literal blanks, that is, VALUE = ' ', to nullify a 
symbolic paranieter. 

For example, if the symbolic parameter UNIT=&NUMBER appears on a DD statement in a 
procedure, code one of the following to nullify it: 

//CALLER EXEC PROC=ABC ,NUMBER= , ACCT=DID58 
// PROC NUMBER= , LOC=POK 

If you nullify a symbolic parameter on the calling EXEC statement, it is nullified, even though 
the procedure's PROC statement contains a default value. 

A symbolic parameter that is last on a statement that is being continued cannot be nullified; it 
must be assigned a value. An attempt to nullify such a parameter results in a JCL error. 

Cautions about Leading and Trailing Commas: When a symbolic parameter is nulUfied, a 
deUmiter, such as a leading or trailing comma, is not removed. In some cases, the remaining 
comma is needed; in others, it will be a syntax error. 

When Symbolic Parameter is Positional 

If a symboUc parameter is a positional parameter, a comma must remain to indicate its 
omission if another positional parameter follows. In this case, code a comma before and 
after the symbolic parameter; the needed commas will remain after nullification. For 
example, «&NUMBER for the unit count: 

UNIT= (3350 , &NUMBER, DEFER) 

When &NUMBER is nullified, the parameter correctly becomes: 

UNIT=(3350, , DEFER) 

When Symbolic Parameter is Not Positional 

If a symbolic parameter is not a positional parameter, a comma must not remain if it is 
omitted. In this case, do not code a comma before the symboUc parameter; no commas 
will remain after nulUfication. For example, serial numbers in the VOLUME = SER 
parameter: 

VOLUME=SER= ( &FIRST&SECOND ) 

If either of the symboUc parameters is nullified, a leading or traiUng comma will not 
remain. If you nuUify &FIRST and assign 222222 for &SECOND or if you nullify 
&SECOND and assign 111111 for &FIRST, the parameter correctly becomes: 

VOLUME=SER= ( 2 2 2 2 2 2 ) 
V0LUME=SER=(111111) 
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Procedures: Symbolic Parameters 

Code a comma when you assign a value to the symboHc parameter and a comma is needed. 
For example: 

//CALLER EXEC FIRST=111111 , SECOND= ', 222222 ' 
Because the comma is a special character, enclose the value in apostrophes. 

Examples of Symbolic Parameters 



// JOBA JOB . . . 

//INSTREAM PROC LOC=POK 

//PSTEP EXEC PGM=WRITER 

//DSA DD SySOUT=A,DEST=&LOC 

// PEND 

//CALLER EXEC PROC=INSTREAM,LOC=NYC 

// 

In this example of an in-stream procedure, the symbohc parameter &LOC is given a default 
value of POK on the PROC statement. Then it is given a current execution value of NYC on 
the calling EXEC statement. 

//JOBB JOB . . . 

//INSTREAM PROC LOC=POK,NUMBER=3350 

//PSTEP EXEC . . . 

//PIN DD DSNAME=REPORT,DISP= (OLD, KEEP ) ,UNIT=&NUMBER 

//POUT DD SYSOUT=A,DEST=&LOC 

// PEND 

//CALLER EXEC PROC=INSTREAM,NUMBER= ,LOC=STL 

//PSTEP. INDATA DD * 

(data) 
/* • 

This code nullifies the symbolic parameter &NUMBER. The calhng EXEC statement 
assignment of STL for symbolic parameter &LOC overrides the PROC statement assignment of 
POK. 
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This example illustrates execution of an in-stream procedure to test symbolic parameters before 
placing the procedure in a procedure library. The in-stream procedure named TESTPROC is: 

//TESTPROC PROC A=IMB406 ,B=ABLE , C=3330 ,D=WXYZ1, 

// E=OLD,F=TRK,G=' 10,10,1' 

//STEP EXEC PGM=&A 

//DDl DD DSNAME=&B,UNIT=&C,VOLUME=SER=&D, DISPOSE, 

// SPACE=(&F, (&G) ) 

// PEND 

To execute this in-stream procedure and override &A with IEFBR14, &B with BAKER, and 
&E with (NEW, KEEP) but leave the other parameters the same, call the in-stream procedure 
with: 

//CALLERl EXEC PR0C=TESTPR0C,A=IEFBR14 ,B=BAKER,E= ' (NEW, KEEP ) ' 

After the symbolic substitution, the statements are: 

//STEP EXEC PGM=IEFBR14 

//DDl DD DSNAME=BAKER,UNIT=3330,VOLUME=SER=WXyZl, 

// DISP=( NEW, KEEP) ,SPACE=(TRK, (10,10,1) ) 



To execute the in-stream procedure in the previous example and change DDl to resemble a 
temporary scratch space, code the following statement: 

//CALLER2 EXEC PROC=TESTPROC , A=IEFBR14 ,B= , C=3350 , D= ,E= 
After the symboUc substitution, the statements are: 

//STEP EXEC PGM=IEFBR14 

//DDl DD DSNAME=,UNIT=3350,VOLUME=SER=,DISP=,SPACE=(TRK, (10,10,1) ) 



Chapter 5. Cataloged and In-Stream Procedures 5-13 



5- 1 4 M VS/XA JCL Reference 



Job Log 



Chapter 6. Job Control Statements on the Output Listing 



Use the JOB statement MSGLEVEL parameter to request that job control statements be 
printed in the job log output Hsting. Code MSGLEVEL = 1,1 to receive the maximum amount 
of information, in the following order: 

• JES messages and job statistics. 

• All job control statements in the input stream and procedures. 

• Messages about job control statements. 

• JES and operator messages about the job's processing: allocation of devices and volumes, 
execution and termination of job steps and the job, and disposition of data sets. 

Statements in Listing: To identify the source and type of each statement, the system prints 
certain characters in columns 1 and 2 or 1, 2, and 3 of the hsting. These identifying characters 
are explained in Figure 6-1 on page 6-2. The hsting shows all procedure statements as they 
appear in the cataloged procedure; the hsting does not show parameter substitutions and 
overrides on the statement itself. 

Symbolic Parameters: The job log listing shows the symbolic parameters in procedure 
statements. The values assigned to the parameters are given in IEF653I messages. These 
messages appear immediately after each statement that contains symbohc parameters. 

EXEC Overriding Parameters: A procedure EXEC statement appears in the job log listing 
exactly as it appears in the procedure. Overridden parameters must be shown by the program 
being executed: 

• For the EXEC statement that executes the assembler program, the Diagnostic Cross 
Reference and Assembler Summary produced by the assembler program shows the 
overriding parameters. 

• For the EXEC statement that executes the linkage editor, the linkage editor listing shows 
the overriding parameters. 
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Columns 
1, 2, and 3 


Source and Type of Statement 


Job Control Statements in the Input Stream 


// 


JCL statement 


//* 


Job control statement that is not a JCL comment statement 
but one that the system considers to contain only comments 


*** 


JES2 statement 


*** 


JES3 statement 


*** 


JCL comment statement 


Cataloged Procedure Statements 


XX 


DD statement that was not overridden and all other JCL 
statements, except the JCL comment statement. Each statement 
appears in the listing exactly as it appears in the procedure. 


x/ 


DD statement that was overridden (preceded by the overriding 
DD statement) 


XX* 


Job control statement that is not a JCL comment statement 
but one that the system considers to contain only comments 


*** 


JCL comment statement 


In-Stream Procedure Statements 


+ + 


DD statement that was not overridden and all other JCL 
statements, except the JCL comment statement. Each statement 
appears in the listing exactly as it appears in the procedure. 


+ / 


DD statement that was overridden (preceded by the overriding 
DD statement) 


+ +* 


Job control statement that is not a JCL comment statement 
but one that the system considers to contain only comments 


*** 


JCL comment statement 



Figure 6-1. Identification of Statements in Job Log 
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Chapter 7. JCL Command Statement 



Purpose: Use the JCL command statement to enter an operator command through the input 
stream. 

Note: The JCL command statement is supported only on JES2 systems. JESS ignores all JCL 
command statements; use JES3 command statements. 

The system usually executes an in-stream command as soon as it is read. Therefore, the 
command will not be synchronized with the execution of any job or step in the input stream. 
To synchronize a command with the job processing, tell the operator the commands you want 
and when they should be issued, and let the operator enter them from the console. 

JES2 processes each command according to installation options for the input device from which 
the job was read. 

References: For more information on commands and for descriptions of their parameters, see 
System Commands. 

Syntax: 



// command [parameter] [comments] 



The command statement consists of the characters // in columns 1 and 2 and three fields: 
operation (command), parameter, and comments. 

Do not continue a command statement. 



Operation Field 

The operation field contains the operator command and is coded as follows: 

• Precede and follow the command with one or more blanks. It can begin in any column. 

• Code the command or a vahd abbreviation for the command. The following operator 
commands can be entered through the input stream. 

CANCEL MONITOR SEND STOP 

CHNGDUMP MOUNT SET STOPMN 

DISPLAY PAGEADD SETDMN UNLOAD 

HOLD RELEASE SLIP VARY 

LOG REPLY START WRITELOG 

MODIFY RESET 
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JCL Command Statement 

Parameter Field 

Code any required parameters. When more than one parameter is coded, separate them with 
commas. 

Comments Field 

The comments field follows the parameter field after at least one intervening blank. 

Location in the JCL 

A command statement can appear immediately before a JOB statement, an EXEC statement, a 
null statement, or another command statement. However, a command statement must not be 
placed before the first JOB statement in an input stream. 

If a command statement contains errors, it is not executed. If the erroneous statement is 
between two jobs in the input stream, the system does not issue a message to indicate that the 
command is not executed. 

Example of the Command Statement 



// DISPLAY TS,LIST 

In response to this command statement, the system displays the number and userid of all active 
time-sharing users of the system. 
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Chapter 8. Comment Statement 



Purpose: Use the comment statement to enter a comment on the output listing. The comment 
statement is used primarily to document a job and its resource requirements. 

Syntax: 



//* comments 



The comment statement consists of the characters //* in columns 1, 2, and 3 and one field: 
comments. 

Code the comments in columns 4 through 80. The comments field does not need to be 
preceded or followed by blanks. 

Do not continue a comment statement using continuation conventions. Instead, code 
additional comment statements. 



Location in the JCL 



Place a comment statement anywhere after the JOB statement. You can place a comment 
statement between continuations of JCL statements. 

Listing of Comments Statements 

Use the MSGLEVEL parameter on the JOB statement to request that the job log output Usting 
contain all the JCL statements for your job. On this Hsting, comment statements have *** in 
columns 1, 2, and 3. 

Examples of the Comment Statement 



//*THE COMMENT STATEMENT CANNOT BE CONTINUED, 
//*BUT IF YOU HAVE A LOT TO SAY, YOU CAN FOLLOW A 
//*COMMENT STATEMENT WITH MORE COMMENT 
//* STATEMENTS. 
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Chapter 9. CNTL Statement 



Purpose: Use the CNTL statement to mark the beginning of program control statements in the 
input stream. Program control statements specify control information for a subsystem. The 
program control statements are ended by an ENDCNTL statement and are called a 
CNTL/ENDCNTL group. 

The DD statement that defines a data set to be processed by a subsystem must refer to the 
CNTL statement in order for the subsystem to use the program control statements in processing 
the data set. 

References: The program control statements are documented in the publications for the 
subsystems. For example, see IBM 3800 Printing Subsystem Models 3 and 8 Programmer's 
Guide for information on program control statements for the Print Services Facility (PSF). 

Syntax: 



//label CNTL [ * comments] 



The CNTL statement consists of the characters // in columns I and 2 and four fields: label, 
operation (CNTL), parameter (*), and comments. The * parameter is required only when 
comments follow. 



Label Field 



Code a label on every CNTL statement, as follows: 

• Each label must be unique within the job. 

• The label must begin in column 3. 

• The label is 1 through 8 alphanumeric or national characters. 

• The first character must be alphabetic or national. 

• The label must be followed by at least one blank. 



Operation Field 



The operation field consists of the characters CNTL and must be preceded and followed by at 
least one blank. It can begin in any colimm. 
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Parameter Field 

The parameter field contains only an asterisk. When present, the asterisk must be preceded and 
followed by at least one blank. The asterisk is required only when the statement contains 
comments. 

Comments Field 

The comments field follows the asterisk after at least one intervening blank. 

Location in the JCL 

A CNTL statement must appear before the DD statement that refers to it. The CNTL and its 
referencing DD statement must be in the same job step or in the same cataloged or in-stream 
procedure step. A CNTL statement can be in a procedure and the referencing DD statement 
can be in the calling job step, but not vice versa. 

Program Control Statements 

Program control statements supply control information for a subsystem. A subsystem can 
require one or more program control statements. The one or more statements must be 
immediately preceded by a CNTL statement and immediately followed by an ENDCNTL 
statement. 

Do not code JCL statements within a program control group. 

Program Control Statements in Procedures 

You can code symbolic parameters on program control statements in a cataloged or in-stream 
procedure. 

You can override parameters on program control statements in a procedure. Follow the rules 
used for overriding DD statement parameters in a procedure. For more information, see 
"Modifying OUTPUT JCL and DD Statements" on page 5-3. 

Example of the CNTL Statement 



//STEPl EXEC PGM=PRINT 

//ALPHA CNTL * PROGRAM CONTROL STATEMENT FOLLOWS 

//PRGCNTL PRINTDEV BUFNO=20 ,PIMSG=YES ,DATACK=BLOCK 

//OMEGA ENDCNTL 

//AGAR DD UNIT=3800-3,CNTL=*. ALPHA 

The PSF subsystem uses the BUFNO, PIMSG, and DATACK options of the PRINTDEV 
control statement to print the data set for DD statement AGAR on a 3800 model 3. 
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Chapter 10. DD Statement 



Purpose: Use the DD (data definition) statement to describe a data set and to specify the input 
and output resources needed for the data set. 

The parameters you can specify for data set definition are arranged alphabetically in the 
following pages. 

References: For information about the JES initialization parameters that provide installation 
defaults, see SPL: JES2 Initialization and Tuning and SPL: JESS Initialization and Tuning. 

Syntax: 



// 


ddname 
procstepname . ddname 


DD [positional-parameter] [ , keyword-parameter] . . . [comments] 


// 


ddname 
procstepname . ddname 


DD 


• 


The DD statement consists of the characters // in columns 1 and 2 and four fields: name, operation 
(DD), parameter, and comments. Do not code comments if the parameter field is blank. 


• 


A DD statement is required for each data set. 


• 


The maximum DD statements per job step are: 




— 1635, in a JES2 system. 

— Determined by the installation, in a JES3 system. 



Name Field 

When specified, code a ddname as follows: 

• Each ddname should be unique within the job step. If duplicate ddnames appear in a job 
step, processing is as follows: 

- In a JES2 system: The system performs device and space allocation and disposition 
processing for both DD statements; however, it directs all references to the first DD 
statement in the step. 
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- In a JES3 system: If both DD statements request JES3- or jointly-managed devices, 
the system cancels the job during JES3 interpretation. If only one or if neither DD 
statement requests JES3- or jointly-managed devices, the system performs device and 
space allocation and disposition processing for both DD statements; however, it directs 
all references to the first DD statement in the step. 

• The ddname must begin in column 3. 

• The ddname is 1 through 8 alphanumeric or national characters. 

• The first character must be alphabetic or national. 

• The ddname must be followed by at least one blank. 
Omitting the ddname: Do not code a ddname in two cases: 

• The DD statement defines a data set that is concatenated to the data set of the preceding 
DD statement. 

• The DD statement is the second or third consecutive DD statement for an indexed 
sequential data set. 

ddname when Overriding or Adding to Procedures: On a DD statement that overrides a 
procedure DD statement, code in the name field the name of the procedure step containing the 
overridden DD statement, followed by a period, followed by the ddname of the procedure DD 
statement to be overridden. On a DD statement that is to be added to a procedure, code in the 
name field the name of the procedure step, followed by a period, followed by a ddname of your 
choosing. For example: 

//PROCSTPl.DDA DD parameters 

Special ddnames: Use the following special ddnames only when you want to use the facilities 
these names represent to the system. These facilities are explained in Chapter 11, "Special DD 
Statements." 

JOBCAT SYSCHK 

JOBLIB SYSCKEOV 

STEPCAT SYSIN 

STEPLIB SYSMDUMP 

SYSABEND SYSUDUMP 

Tiie following ddnames have special meaning to JES3; do not use them on a DD statement in a 
JES3 system. 

JCBIN JESJCL 

JCBLOCK JESMSG 

JCBTAB JOURNAL 

JCLIN JST 

JESInnnn SYSMSG 
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Operation Field 



The operation field consists of the characters DD and must be preceded and followed by at 
least one blank. It can begin in any column. 



Parameter Field 



A DD statement has two kinds of parameters: positional and keyword. All parameters are 
optional. However, leave the parameter field blank only on a DD statement that overrides a 
DD statement for a concatenated data set in a cataloged or in-stream procedure. 

Positional Parameters: A DD statement can contain one positional parameter. If coded, this 
positional parameter must precede all keyword parameters. 



POSITIONAL PARAMETERS 


VALUES 


PURPOSE 


r * 1 

[DATA J 

See page 10-12 or 10-35 


*: for data sets containing no JCL 
DATA: for data sets containing JCL 


Begins an in-stream data set. 


DUMMY 

See page 10-82 




Specifies no space allocation, no 
disposition processing, and, for 
BSAM and QSAM, no I/O. 


DYNAM 
See page 10-85 




(Parameter is supported to 
provide compatibility with 
previous systems.) 



Keyword Parameters: A DD statement can contain the following keyword parameters. You 
can code any of the keyword parameters in any order in the parameter field after a positional 
parameter, if coded. 



KEYWORD PARAMETERS 


VALUES 


PURPOSE 


ACCODE = access-code 
See page 10-15 


access-code: 1 - 8 characters, first must 
be upper case A - Z 


Specifies or changes an 
accessibility code for an 
ISO/ANSI/FIPS Version 3 tape 
output data set. 
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KEYWORD PARAMETERS 


VALUES 


PURPOSE 


AMP = (subparameter) 


see VSAM Administration Guide 


Completes information in an 


AMP = ('subparameter[,subparameter]../) 




access method control block 
(ACB) for a VSAM data set. 


subparameters: 






AMORG 






BUFND = number 






BUFNI = number 






BUFSP = bytes 






CROPS = 


RCKl 

NCK 
NRE 
NRC 








OPTCD = 


I 
L 
IL 
















RECFM = 


■F 1 
FB 
V 
VB 








STRNO = number 






SYNAD == modulename 






TRACE 






See page 10-17 






BURST- 


YES 




YES or Y: burster-trimmer-stacker 


Directs output to a stacker 




Y 




NO or N: continuous forms stacker 


on a 3800 Printing Subsystem. 




NO 

N 








See page 10-22 








table-name 




1 - 4 table-name subparameters: 


Names character-arrangement 


CHARS = 


(table-name[, table-name] . . .) 




1-4 alphanumeric or national characters 


tables for printing on a 3800 




DUMP 




DUMP: 204-character print lines on 3800 


Printing Subsystem. Requests a 




DUMP[,table-name]...) 






high-density dump on a 






SYSABEND or SYSUDUMP 






DD statement. 


See page 10-24 






CHKPT=EOV 




Requests a checkpoint at each 
end-of-volume, except the last. 


See page 10-27 








*.label 




label: names CNTL statement 


Causes the system to execute 


CNTL = 


*.stepname.label 




stepname: CNTL in named step 


statements following an earlier 




*.stepname.procstepname.labeI 




procstepname: step in named procedure 


CNTL statement. 


See page 10-29 








nnn 




nnn (JES2): 1 - 255 


Specifies number of copies 


COPIES = 


(nnn,(group-value[,group-value]...)) 




nnn (JES3): 1 - 254 


printed. For a 3800 Printing 




(,group-value[,group-value]...)) 




1 - 8 group-values (JES2): 1 - 255 


Subsystem, can instead specify 




1 - 8 group values (JES3): 1 - 254 


number of copies of each page 
printed before the next page is 
printed. 


See page 10-31 
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KEYWORD PARAMETERS 


VALUES 


PURPOSE 


DCB = (subparameter[,subparameter]...) 


subparameter: see tables in DCB parameter 


Completes information in data 




description 


control block (DCB). 


DCB = 


dsname: copy DCB information from named 




/ 


dsname 


\ 


cataloged data set 






*.stepname.ddname 




ddname: copy DCB parameter from named 






*.stepname.procstepname.ddname 




earlier DD statement 




\ '/ 


stepname: DD in named step 




\ [,subparameter]... / 


procstepname; step in named procedure 




See page 10-38 






DDNAME = ddname 


ddname: names later DD statement 


Postpones defining the data set 
until later in same step: on a 
DD statement in the calling step 
or in a procedure called by the 
step. 


See page 10-55 






DEST = destination 


LOCAL or ANYLOCAL: local device 


Sends a sysout data set to the 




name: named local or remote device 


specified destination. 


destination (JES2): 


Nnnnn: node (1 - 1000) 




LOCAL 


NnRm: node (1 - 1000) and remote work 




name 


station (1 - 4000); 6 digits maximum 




Nnnnn 


for n and m combined 




NnnRnimmm to NnnnnRmm 


Rnnnn or RMnnnn or RMTnnnn: remote 




Rnnnn or RMnnnn or RMTnnnn 


terminal (1 - 4000) 




Unnnn 


Unnnn: local terminal (1 - 4000) 




(node,userid) 


(node,userid): node (1 - 8 alphanumeric 
or national characters) and TSO userid 




destination (JES3): 


(1-7 alphanumeric or national characters) 




ANYLOCAL 


or VM userid (1-8 alphanumeric or 




device-name 


national characters) 




device-number 


device-number: 3-number address 




group-name 


device-name: local device (1-8 alphanumeric 




nodename 


or national characters) 




(node,userid) 


group-name: 1 or more local devices 
or remote stations (1-8 alphanumeric or 
national characters) 

nodename: node (1-8 alphanumeric or 
national characters) 




See page 10-59 






DISP = status 


status: NEW, OLD, SHR (for shared). 


Describes the status of the data 


DISP = ([status][,normal-termination-disp] 


MOD (for data set to be modified) 


set and tells the system to do the 


[.abnormal-termination-disp]) 


normal-termination-disp: DELETE, KEEP. 


following with the data set after 




PASS, CATLG, or UNCATLG 


normal or abnormal termination 




abnormal-termination-disp: DELETE, 


of the step or job: delete or keep 




KEEP, CATLG, or UNCATLG 


it on its volume(s), pass it to a 
later step, or add it to or 
remove it from the catalog. 


See page 10-63 
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KEYWORD PARAMETERS 


VALUES 


PURPOSE 


DLM = delimiter 


delimiter: 2 characters 


Terminates an in-stream data 

set. 


Seepage 10-73 




DS1D = 


id 




id: 1 - 8 characters 


Identifies a data set on a 




(idJVl) 




V: label was verified (only on a SYSIN 


diskette of a 3540 Diskette 




DD statement) 


Input/Output Unit. 


See page 10-75 








dsname 


unqualified dsname: 1 - 8 alphanumeric or 


Names the data set. 




dsname(member-name) 


national characters, -, + 








dsname(generation-number) 


qualified dsname: multiple names joined by 




DSNAME 


, = 


dsname(area-name) 


periods 




DSN 




&&dsname 


member-name: member in PDS 




' i 


&&dsname(member-name) 


generation-number: or signed integer 






&&dsname(area-name) 


area-name: INDEX, PRIME, or OVFLOW 






*.ddname 


area in indexed sequential data set 






*.stepname.ddname 


*.ddname: copy dsname from earlier DD 






*.stepname.procstepname.ddname 


stepname: DD in named step 






NULLFILE 


procstepname: step in named procedure 






NULLFILE: dummy data set 




See page 10-77 






FCB = 


fcb-name 




fcb-name: 1 - 4 alphanumeric or national 


Specifies FCB image, carriage 




fob-name [.ALIGN 1 




characters 


control tape for 1403 Printer, or 




.VERIFY 




ALIGN: operator check forms alignment 


data-protection image for 3525 


L J f 


VERIFY: operator verify FCB image 


Card Punch. 


See page 1 0-86 








overlay-name 




overlay-name: forms overlay frame (1-4 


For printing on a 3800 Printing 


FLASH = 


(overlay-name[,count]) 




alphanumeric or national characters) 


Subsystem, indicates that the 




NONE 




count: copies with overlay (0 - 255) 


data set is to be printed with the 




NONE: suppresses flashing 


named forms overlay and can 
specify how many copies are to 
be flashed. 


See page 10-90 






FREE = 


END 




END: deallocate at end of step 


Specifies when to deallocate the 




CLOSE 




CLOSE: deallocate when data set is closed 


resources for this data set. 


See page 10-93 






HOLD = 


YESl 


YES or Y: holds this sysout data set 


Tells the system to hold this 




Y 




NO or N: allows normal processing for this 


sysout data set until released by 




NO 

N 




sysout data set's output class 


the operator. 


See page 10-96 
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DD 



KEYWORD PARAMETERS 


VALUES 


PURPOSE 


LABEL = 


data-sel-seq-no: data set position on tape 


Specifies information about a 


/ [data-set-seq-no][,label-lype] 


.PASSWORD 


\ 


volume (1-4 decimal digits) 


data set's label, password. 




.NOPWREAD 




label-type: 
SL: IBM standard labels 


opening, expiration date, and, 
for a tape data set, relative 


. ' ' 


SUL: IBM standard and user labels 


position on the volume. 




,IN 


r,RETPD = nnnn l 


AL: ISO/ANSI Version 1 and 




\ 


,OUT 


[,EXPDT = yydddJ / 


ISO/ANSI/FIPS Version 3 labels 
AUL: user labels and ISO/ANSI Version 1 




\ L -J r 


and ISO/ANSI/FIPS Version 3 labels 

NSL: nonstandard labels 

NL: no labels 

BLP: bypass label processing 

LTM: leading tapemark 
PASSWORD: password required to access 

data set 
NOPWREAD: password required to change 

or delete data set 
IN: only read BSAM data set opened for 

INOUT or BDAM data set opened 

for UPDAT 
OUT: only write to BSAM data set opened 

for OUTIN or OUTINX 
RETPD = nnnn: retention period (nnnn: 1 - 4 

decimal digits) 
EXPDT = yyddd: expiration date (yy: 2-digit 

year, ddd: day 001 - 366) 




See page 10-98 






MODIFY = 


module-name 




module-name: 1 - 4 alphanumeric or 


Specifies a copy-modification 




(module-namef.trcl) 




national characters 


module in SYSl.IMAGELIB to 




trc: table-name in CHARS parameter 


be used by JES to print the data 




(0 for first, 1 for second, 2 for third, 


set on a 3800 Printing 




and 3 for fourth table-name) 


Subsystem. 


See page 10-105 






, 


id 




id: group of mass storage volumes 


Places the data set on a group 


MSVGP= 


(id[,ddname]) 




(1-8 alphanumeric or national characters) 


of mass storage volumes on an 




SYSGROUP 




ddname: allocates this data set to volume(s) 


MSS device. 


\ / 


other than those for DD statement ddname 






SYSGROUP: default group of mass storage 






volumes 




See page 10-107 






OUTLIM = number 


number: 1 - 16777215 logical records 


Limits the logical records in this 




maximum 


sysout data set. 


Seepage 10-110 






OUTPUT = 


reference 




name: names earlier OUTPUT JCL statement 


Associates this sysout data set 




(reference[,reference] . . . 




stepname: OUTPUT JCL in named step 


with one or more OUTPUT 




procstepname: step in named procedure 


JCL statements. 


reference: 






*.name 






♦.stepname.name 






*.stepname.procstepname.name 






Seepage 10-112 
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DD 



KEYWORD PARAMETERS 



VALUES 



PURPOSE 



PROTECT = YES 



Seepage 10-116 



Requests that RACF create a 
discrete profile to protect a data 
set on direct access or a tape 
volume. 



QNAME = procname[.tcainname] 



See page 10-120 



procname: names a TPROCESS macro 
that defines a destination queue for 
the messages 

tcamname: names a TCAM job or started task 
to process the messages 



Indicates that this data set 
contains TCAM messages. 



For system assignment of space: 

1/ 



SPACE = 
TRK, 
CYL 

blklgth 



primary-qty 



,directory 
,index 



,RLSE 



,second-qty 



,CONTIG 

,MXIG 

,ALX 



[,ROUND] 



To request specific tracks: 

SPACE = - 
[ABSTR, I primary -qty.address 



.directory 
,index 



See page 10-121 



TRK: allocation in tracks 
CYL: allocation in cylinders 
blklgth: allocation in average blocks, 

1 - 65535 
primary-qty: number of tracks, cylinders, or 

blocks to be allocated 
second-qty: additional tracks or cylinders to 

be allocated, if more are needed 
directory: number of 256-byte records for 

PDS directory 
index: tracks or cylinders for index of indexed 

sequential data set 
RLSE: release unused space when data set 

is closed 
CONTIG: contiguous primary allocation 

MXIG: allocation in largest available space 

(not supported for indexed sequential data 

sets) 
ALX: allocation of up to 5 separate 

contiguous primary quantities 
ROUND: allocation by block length rounded 

to integral cylinders 
ABSTR: allocation at the specified address 
address: track number of first track to be 

allocated 



Requests space for a new data 
set on direct access storage. 



SUBSYS = I subsystem-name 

I [,subsystem-parameter].. 

See page 10-127 



subsystem-name: identifies the subsystem 
subsystem-parameter: specifies information 
for the subsystem 



Requests a subsystem to process 
this data set. 



SYSOUT = class 
SYSOUT = 



[class] 



,writer-name 
JNTRDR 



,form-name 
,code-name 



SYSOUT=* 
SYSOUT = G) 

See page 10-130 



- 8 alphanumeric or national 
4 alphanumeric or national 



class: A - Z, 
writer-name: 1 

characters 
form-name: 1 

characters 
code-name: 1-4 alphanumeric or national 

characters (JES2 only) 
*: same output class as MSGCLASS 

parameter on JOB statement 



Defines this data set as a sysout 
data set and (1) assigns it to an 
output class, (2) requests 
external writer to process it, 
(3) identifies print or punch 
forms, and (4) refers to the 
code-name of a JES2 
/♦OUTPUT statement. 
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DD 



KEYWORD PARAMETERS 



VALUES 



PURPOSE 



TERM = TS 



See page 10-137 



In a foreground job, indicates 
that this data set is coming from 
or going to a TSO userid. In a 
batch job, indicates that this DD 
statement begins an in-stream 
data set. 



ucs= 

character-set-code 
(character-set-code 



See page 10-139 



,FOLD 



[, VERIFY]) 



character-set-code: 1-4 alphanumeric or 

national characters 
FOLD: operator load chain or train in fold 

mode (JES2 only) 
VERIFY: operator verify UCS image 



Specifies universal character set, 
print train, or character- 
arrangement table for a 3800 
Printing Subsystem. 



device-number 
UNIT = I device-type 
group-name 

UNIT = AFF = ddname 



See page 10-142 



jUnit-count 
,P 



[,DEFER] 



device-number: 3-digit hexadecimal number 
device-type: machine type and model 
group-name: 1 - 8 alphanumeric or national 

characters 
unit-count: 1 - 59 
P: allocate same number of devices as volumes 

for parallel mount 
DEFER: defers mounting until open 
AFF = ddname: requests allocation of same 

devices as for DD statement ddname 



Requests allocation to a specific 
device, a type or group of 
devices, or the same device(s) as 
another data set. Also can 
specify how many devices and 
deferred mounting. 



VOLUME 
VOL 
[PRIVATE] 



,RETAIN 



,volume-seq-no 



[,volume-count] 



[,] 



SER = (serial-number [,serial-number]...) 

REF = dsname 

REF = *. ddname 

REF = *.stepname.ddname 

REF = *.stepname.procstepname.ddname 

REF = *.procstepname.ddname 



Seepage 10-147 



PRIVATE: requests a private volume 
RETAIN: requests private tape volume remain 

mounted and unwound or requests public 

tape volume be retained at device 
volume-seq-no: begins processing with volume 

1 - 255 of existing multivolume data set 
volume-count: maximum volumes for output 

data set (1 - 255) 
1-255 serial-number subparameters: volume 

serial numbers (1-6 alphanumeric, national 

or special characters) 
REF: copy volume serial numbers from 

another data set or earlier DD statement 
dsname: from cataloged or passed data set 
ddname: from named earlier DD statement 
stepname: DD in named step 
procstepname: step in named procedure 



Identifies the volume(s) on 
which a data set resides or will 
reside. 



Comments Field 



Tlie comments field follows the parameter field after at least one intervening blank. If you do 
not code any parameters on a DD statement, do not code any comments. 
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DD 



Location in the J€L 



Most DD statements define data sets to be used in a job step, in a cataloged procedure step, or 
in an in-stream procedure step; these appear after the EXEC statement for the step. Some DD 
statements define data sets for the job, for example, the JOBLIB DD statement; these appear 
after the JOB statement and before the first EXEC statement. 

When Overriding or Adding to Procedures: Place DD statements that override, nullify, or add 
parameters immediately following the EXEC statement that calls the procedure. Place 
overriding and nullifying DD statements first, followed by all added DD statements. Last in 
the calling step are any DD * or DD DATA statements with their in-stream data. 

To override more than one DD statement in a procedure, place the overriding DD statements 
in the same order as the overridden DD statements in the procedure. 



Concatenating Data Sets 



You can logically connect or concatenate sequential or partitioned input data sets for the 
duration of a job step. Each of the concatenated data sets can reside on a different volume. 
For details on concatenating data sets, see Data Administration Guide. 

Coding a Concatenation: To concatenate data sets, omit the ddnames from all the DD 
statements except the first in the sequence. The data sets are processed in the same sequence as 
the DD statements defining them. 

Devices for Concatenated Data Sets: Concatenated data sets can reside on different devices and 
different types of devices. However, do not concatenate data sets on direct access devices with 
Rotational Position Sensing (RPS) and data sets on non-RPS devices. 

Block Sizes for Concatenated Data Sets: Concatenated data sets can have different block sizes 
as long as the data set with the largest block size appears first in the concatenation. 

References to Concatenated Data Sets: If you make a backward reference to a concatenation 
(using *.), the system obtains information only from the first data set defined in the sequence of 
DD statements. 

If you make a forward reference to a concatenation (using the DDNAME parameter), the 
system obtains information only from the first data set defined in the sequence of DD 
statements. 

If you issue an assembler RDJFCB macro instruction to a data set that is in a concatenation, 
the system reads the job file control block (JFCB) for only the first data set defined in the 
sequence of DD statements. 

Do Not Concatenate Data Sets to a DUMMY Data Set: If you define a data set using the 
DUMMY parameter, do not concatenate other data sets to it. When the processing program 
asks to read a dummy data set, the system takes an end-of-data set exit immediately and 
ignores any data set that might be concatenated to the dummy. 
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Examples of DD Statements and ddnames 



//MYDS DD DSNAME=REPORT 
//A DD DSNAME=FILE 



//INPUT DD DSNAME=FGLIB,DISP=( OLD, PASS) 
// DD DSNAME=GR0UP2,DISP=SHR 

In this example, because the ddname is missing from the second DD statement, the system 
concatenates the data sets defined in these statements, 

//PAYROLL . DAY DD DSNAME=DESK,DISP=SHR 

In this example, if procedure step PAYROLL contains a DD statement named DAY, this 
statement overrides parameters on DD statement DAY. If the step does not contain DD 
statement DAY, the system adds this statement to procedure step PAYROLL for the duration 
of the job step. 

//STEPSIX.DD4 DD DSNAME=TEXT,DISP= (NEW, PASS) 
// DD DSNAME=ART,DISP=SHR 

In this example, the second data set is concatenated to the first, and both are added to 
procedure step STEPSIX. The ddname is omitted from the second DD statement in order to 
concatenate data set ART to data set TEXT. 
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* Parameter 



Parameter Type: Positional, optional 

Purpose: Use the * parameter to begin an in-stream data set. The data records immediately 
follow the DD * statement; the records must be in BCD or EBCDIC. The data records end 
when one of the following is found: 

/* in the input stream 

// to indicate another JCL statement 

The two-character delimiter specified by a DLM parameter on this DD statement 

The input stream runs out of card images 

Use a DATA parameter instead of the * parameter if any of the data records start with //. 

Syntax: 



//ddname DD * [ , parameter] . . . [comments] 



Defaults 



When you do not code DCB = BLKSIZE and DCB = LRECL, JES uses installation defaults 
specified at initiaUzation. 



Relationship to Other Parameters 



The only DD parameters that you can code with the * parameter follow. All other parameters 
are a JCL error. 

DCB = BLKSIZE 

DCB=BUFNO 

DCB = LRECL 

DLIVI 

DSID 

VOLU]V[E = SER 

For 3540 Diskette InputI Output Units: VOLUIVIE = SER, DCB = BUFNO, and DSID 

parameters on a DD * statement are ignored except when they are detected by a diskette reader 
as a request for an associated data set. See IBM 3540 Programmer's Reference. On a DD * or 
DD DATA statement processed by a diskette reader, you can specify DSID and 
VOLUIVIE = SER parameters to indicate that a diskette data set is to be merged into the input 
stream following the DD statement. 

For JES3 SNA RJP Input: The only parameters you can specify for JES3 systems network 
architecture (SNA) remote job processing (RJP) input devices are DCB = BLKSIZE and 
DCB = LRECL. 
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Relationship to Other Control Statements 

Do not refer to an earlier DD * statement in DCB, DSNAME, or VOLUME parameters on 
following DD statements. 

Location in the JCL 

A DD * statement begins an in-stream data set. 

In-stream Data for Cataloged or In-stream Procedures: A cataloged or in-stream procedure 
cannot contain a DD * statement. When you call a procedure, you can add input stream data 
to a procedure step by placing in the calling step one or more DD * or DD DATA statements, 
each followed by data. 

Multiple In-stream Data Sets for a Step: You can code more than one DD * or DD DATA 

statement in a job step in order to include several distinct groups of data for the processing 
program. Precede each group with a DD * or DD DATA statement and follow each group 
with a delimiter statement. If you omit a DD statement before and a deUmiter after input data, 
the system provides a DD * statement with the ddname of SYSIN and ends the data when it 
reads a JCL statement or runs out of card images. 

Unread Records 

If the processing program does not read all the data in an in-stream data set, the system skips 
the remaining data without abnormally terminating the step. 

Examples of the * Parameter 



//INPUTl DD * 

data 
//INPUT2 DD * 

data 
/* 
This example defines two groups of data in the input stream. 
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//STEP2 EXEC PROC=FRESH 

//SETUP. WORK DD UNIT=3400-6 ,LABEL= ( ,NSL) 

//SETUP. INPUTl DD * 

data 

/* 

//PRINT. FRM DD UNIT=180 

//PRINT. INP DD * 

data 

/* 

This example defines two groups of data in the input stream. The input data defined by DD 
statement SETUP.INPUTl is to be used by the cataloged procedure step named SETUP. The 
input data defined by DD statement PRINT.INP is to be used by the cataloged procedure step 
named PRINT. 
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ACCODE Parameter 



Parameter Type: Keyword, optional 

Purpose: Use the ACCODE parameter to specify or change an accessibiUty code for an 
ISO/ANSI/FIPS Version 3 tape output data set. An installation-written file-access exit routine 
verifies the code after the code is written to tape. If the code is authorized, the job step's 
program can use the data set; if not, the system issues messages and may abnormally terminate 
the job step. 

A data set protected by an accessibility code should reside only on a volume protected by 
RACF or a volume accessibility code. The volume should not contain any unprotected data 
sets. 

Note: ACCODE is supported only for ISO/ANSI/FIPS Version 3 tape data sets. ACCODE is 
ignored for SL (IBM standard) label tapes. 

References: For more information on ISO/ANSI/FIPS Version 3 tape data sets, see Magnetic 
Tape Labels and File Structure Administration. 

Syntax: 




Subparameter Definition 



Defaults 



access-code 

Specifies an accessibility code. The access-code is 1 through 8 characters; the first 
character is an upper case letter from A through Z. 

Note: Only the first character is used as the ISO/ANSI/FIPS Version 3 accessibihty code; 
the other seven characters can be used by the installation. If the first character is other 
than an upper case letter from A through Z, the installation does not give control to the 
file-access exit routine. 



If no accessibility code is specified on a DD statement that defines an ISO/ANSI/FIPS Version 
3 tape data set, the system writes a blank character PC'40') in the tape label: a blank authorizes 
unlimited access to the tape's data sets. 

If the installation does not supply a file-access exit routine, the system prevents access to any 
ISO/ANSI/FIPS Version 3 tape volume. 
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Overrides 

If PASSWORD or NOPWREAD is coded on the DD statement LABEL parameter, password 
access overrides the ACCODE parameter. 

Example of the ACCODE Parameter 



//TAPE DD UNIT=2400,VOLUME=SER=T49850,DSNAME=TAPEDS, 
// LABEL= ( , AL) , ACCODE=Z 

In this example, the DD statement ACCODE parameter specifies an accessibility code of Z for 
tape volume T49850. The volume has ISO/ANSI/FIPS Version 3 labels. The data set 
TAPEDS is first on the tape. 
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AMP Parameter 



Parameter Type: Keyword, optional 

Purpose: Use the AMP parameter to complete information in an access method control block 
(ACB) for a VSAM data set. The ACB is a control block for entry-sequenced, key-sequenced, 
and relative record data sets. 



Note: AMP is supported only for VSAM data sets. 

References: For more information on AMP and the ACB, see VSAM Administration Guide. 

Syntax: 



AMP= ( subparameter ) 

AMP= ( ' subparameter [ , subparameter ] 

The subparameters are: 



AMORG 

BUFND= 

BUFNI= 

BUFSP= 

CROPS= 



number 
number 
bytes 

fNCKl 

NRC 

NRE 

RCK 



OPTCD= 



I 

L 
IL 

RECFM=^rF 
FB 
Y 
VB 

STRNO=number 

SYNAD=module 

TRACE 



Parentheses: The subparameter or subparameters are always enclosed in one set of 
parentheses. For example, AMP = (AMORG). 

Multiple Subparameters: When the parameter contains more than one subparameter, 
separate the subparameters by commas and enclose the subparameter hst in apostrophes 
inside the parentheses. For example, AMP = (' AMORG,STRNO = 4'). 

Special Characters: When the parameter contains only one subparameter and that 
subparameter contains special characters, enclose the subparameter in apostrophes inside the 
parentheses. For example, AMP = ('STRNO = 4'). 

Note: Do not enclose a subparameter in a subparameter list in apostrophes. 

Continuation onto Another Statement: Enclose the subparameter list in only one set of 
parentheses. Enclose all the subparameters on each statement in apostrophes. End each 
statement with a comma after a complete subparameter. For example: 

//DSl DD DSNAME=VSAMDATA,AMP=( 'BUFSP=200,OPTCD=IL,REGFM=FB' , 
// ' STRN0=6 , TRACE ' ) 
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Subparameter Definition 



AMORG 

Indicates that the DD statement defines a VSAM data set. Code AMORG for either of 
the following reasons: 

• When data set access is through an ISAM interface program and the DD statement 
contains VOLUME and UNIT parameters or contains a DUMMY parameter. 

• To open an ACB for a VSAM data set, if the data set is not fully defined at the 
beginning of the job step. 

BUFND- number 

Specifies the number of I/O buffers that VSAM is to use for data records. The minimum 
is 1 plus the STRNO subparameter number. If you omit STRNO, BUFND must be at 

least 2. 

If you omit BUFND from AMP and from the ACB macro instruction, the system uses 
the STRNO number plus 1 . 

BUFNI = number 

Specifies the number of I/O buffers that VSAM is to use for index records. If you omit 
BUFNI from AMP and from the ACB macro instruction, VSAM uses as many index 
buffers as the STRNO subparameter number; if you omit both BUFNI and STRNO, 
VSAM uses 1 index buffer. 

If data access is through the ISAM interface program, specify for the BUFNI number 1 
more than the STRNO number, or specify 2 if you omit STRNO, to simulate having the 
highest level of an ISAM index resident. Specify a BUFNI number 2 or more greater 
than the STRNO number to simulate having intermediate levels of the index resident. 

BUFSP = bytes 

Specifies the maximum number of bytes for the data and index buffers in the user area. 

If BUFSP specifies fewer bytes than the BUFFERSPACE parameter of the access method 
services DEFINE command, the BUFFERSPACE number overrides the BUFSP number. 

CROPS =NCK 
CROPS =NRC 
CROPS =NRE 
CROPS =RCK 

Requests a checkpoint/restart option. For more information, see Checkpoint j Restart 
User's Guide. 

NCK 

Requests no data set post-checkpoint modification tests. 

NRC 

Requests neither a data-erase test nor data set post-checkpoint modification tests. 
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NRE 

Requests no data-erase test. 

RCK 

Requests a data-erase test and data set post-checkpoint modification tests. If the 
CROPS subparameter is omitted, RCK is the default. 



If you request an inappropriate option, such as the data-erase test for an input data set, 
the system ignores the option. 

OPTCD = I 
OPTCD = L 
OPTCD = IL 

Indicates how the ISAM interface program is to process records that the step's processing 
program flags for deletion. 



Requests, when the data control block (DCB) contains OPTCD = L, that the ISAM 
interface program is not to write into the data set records marked for deletion by 
the processing program. 

If AMP = ('OPTCD = r) is specified without OPTCD = L in the DCB, the system 
ignores deletion flags on records. 



Requests that the ISAM interface program is to keep in the data set records marked 
for deletion by the processing program. 

If records marked for deletion are to be kept but OPTCD = L is not in the DCB, 
AMP = ('OPTCD = L') is required. 

Note: This parameter has the same meaning and restrictions for the ISAM 
interface as it has for ISAM. While it was not required in the ISAM job control 
language, you should code it in the AMP parameter. 



IL 



Requests that the ISAM interface program is not to write into the data set records 
marked for deletion by the processing program. If the processing program had read 
the record for update, the ISAM interface program deletes the record from the data 
set. 

AMP = ('OPTCD = IL') has the same effect as AMP = ('OPTCD = F) coded with 
OPTCD = Lin the DCB. 
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RECFM^F 
RECFM = FB 
RECFM = V 
RECFM = VB 

Identifies the ISAM record format used by the processing program. You must code this 
RECFM subparameter when the record format is not specified in the DCB. 

Note: This parameter has the same meaning and restrictions for the ISAM interface as it 
has for ISAM. While it was not required in the ISAM job control language, you should 
code it in the AMP parameter. 

All VSAM requests are for unblocked records. If the processing program requests blocked 
records, the ISAM interface program sets the overflow-record indicator for each record to 
indicate that each is being passed to the program unblocked. 



F 



FB 



V 



VB 



Indicates fixed-length records. 
Indicates blocked fixed-length records. 



Indicates variable-length records. If no RECFM is specified in the AMP parameter 
or in the DCB, V is the default. 



Indicates blocked variable-length records. 



STRNO = number 

Indicates the number of request parameter lists the processing program uses concurrently. 
The number must at least equal the number of BISAM and QISAM requests that the 
program can issue concurrently. If the program creates subtasks, add together the 
number of requests for each subtask plus 1 for each subtask that sequentially processes 
the data set. For details, see VSAM Administration Guide, exit 

SYNAD = module 

Names a SYNAD exit routine. The ISAM interface program is to load and exit to this 
routine if a physical or logical error occurs when the processing program is gaining access 
to the data set. 

The SYNAD parameter overrides a SYNAD exit routine specified in the EXLST or 
GENCB macro instruction that generates the exit Hst. The address of the intended exit 
list is specified in the access method control block that links this DD statement to the 
processing program. If no SYNAD exit is specified, the system ignores the AMP 
SYNAD parameter. 

TRACE 

Indicates that the generahzed trace facility (GTF) executes with your job to gather 
information about opening and closing data sets and end-of-volume processing. You can 
use the AMDPRDMP program to print the trace output; see SPL: Service Aids. 



10-20 MYS/XA JCL Reference 



DD: AMP 



Relationship to Other Parameters 

Do not code the following parameters with the AMP parameter. 



* 


DLM 


OUTPUT 


BURST 


DYNAM 


QNAME 


CHARS 


FCB 


SPACE 


COPIES 


FLASH 


SYSOUT 


DATA 


MODIFY 


TERM 


DCB 


OUTLIM 


UCS 


ilid ddnames 


; The following ddnj 


JOBLIB 






STEPLIB 






SYSABEND 






SYSCHK 






SYSCKEOV 






SYSMDUMP 






SYSUDUMP 







Invalid DSNAMEs: When you code the AMP parameter, the DSNAME must not contain 
parentheses, a minus (hyphen), or a plus ( + ) sign. The forms of DSNAME valid for ISAM, 
partitioned access method (PAM), and generation data groups (GDG) are invalid with VSAM 
data sets. 



Buffer Requirements 



For a key-sequenced data set, the total minimum buffer requirement is three: two data buffers 
and one index buffer. For an entry-sequenced data set, two data buffers are required. 

If the number of buffers specified in the BUFND and BUFNI subparameters causes the virtual 
storage requirements to exceed the BUFSP space, the number of buffers is reduced to fit in the 
BUFSP space. 

If BUFSP specifies more space than required by BUFND and BUFNI, the number of buffers is 
increased to fill the BUFSP space. 



Examples of the AMP Parameter 



//VSAMDSl DD DSNAME=DSM. CLASS, DISP=SHR, AMP= ( •BUFSP=200,BUFND=2' , 
// ' BUFNI=3 , STRN0=4 , SYNAD=ERROR ' ) 

In this example, the DD statement defines the size of the user area for data and index buffers, 
specifies the number of data and index buffers, specifies the number of requests that require 
concurrent data set positioning, and specifies an error exit routine named ERROR. 

//VSAMDS2 DD DSNAME=DSM. CLASS ,DISP=SHR,AMP= ( ' BUFSP=23456 ,BUFND=5 ' , 
// • BUFNI= 10, STRNO=6,SYNAD=ERROR2,CROPS=NCK, TRACE • ) 

In this example, the DD statement defines the values for BUFSP, BUFNI, STRNO, and 
SYNAD, as in the previous example. It also specifies that a data set post-checkpoint 
modification test is not to be performed when restarting at a checkpoint and that GTF is to 
provide a trace. 
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BURST Parameter 



Parameter Type: Keyword, optional 

Purpose: Use the BURST parameter to specify that the output for this sysout data set printed 
on a 3800 Printing Subsystem is to go to: 

• The burster-trimmer-stacker, to be burst into separate sheets. 

• The continuous forms stacker, to be left in continuous fanfold. 

If the specified stacker is different from the last stacker used, or if a stacker was not previously 
requested, JES issues a message to the operator to thread the paper into the required stacker. 

Note: BURST is vaHd only for an output data set printed on a 3800 equipped with a 
burster-timmer-stacker. 



Syntax: 






BURST= 


'YES' 
Y 






NO 

N 





Subparameter Definition 

YES 



Defaults 



Overrides 



Requests that the printed output is to be burst into separate sheets. This subparameter 
can also be coded as Y. 

NO 

Requests that the printed output is to be in a continuous fanfold. This subparameter can 
also be coded as N. 



If you do not code a BURST parameter, but you code a DD SYSOUT parameter and the 
sysout data set is printed on a 3800 that has a burster-timmer-stacker, JES uses an installation 
default specified at initialization. 

If you do not code a BURST parameter or a DD SYSOUT parameter, the default is NO. 



A BURST parameter on a sysout DD statement overrides an OUTPUT JCL BURST 

parameter. 
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Relationship to Other Parameters 

Do not code the following parameters with the BURST parameter. 



* 


DLM 


MSVGP 


AMP 


DSID 


PROTECT 


DATA 


DSNAME 


QNAME 


DDNAME 


DYNAM 


VOLUME 


DISP 


LABEL 





Relationship to Other Control Statements 

The burster-trimmer-stacker can also be requested using the following: 

• The BURST parameter on the OUTPUT JCL statement. 

• The STACKER parameter on the JES3 //*FORMAT PR statement. 

• The BURST parameter on the JES2 /*OUTPUT statement. 

Example of the BURST Parameter 



//RECORD DD SYSOUT=A,BURST=Y 

In this example, the DD statement requests that JES send the output to the 

burster- trimmer-stacker of the 3800. The stacker separates the printed output into separate 

sheets instead of stacking it in a continuous fanfold. 
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CHARS Parameter 



Parameter Type: Keyword, optional 

Purpose: Use the CHARS parameter to specify the name of one or more 
character-arrangement tables for printing this sysout data set on a 3800 Printing Subsystem. 

Note: CHARS is valid only for an output data set that is printed on a 3800. 

References: For more information on character-arrangement tables, see the 3800 Printing 
Subsystem Programmer's Guide. Refer to Installation: System Generation for information on 
how to choose during system generation particular groups, other than the Basic group, which is 
always available. 



Syntax: 



CHARS= 



ftable-name 
( table-name [ , table-name] . . . ) 
DUMP 
(DUMP[ , table-name] . . . ) 



You can omit the parentheses if you code only one table-name or only DUIVIP. 

Null positions in the CHARS parameter are invalid. For example, you cannot code 
CHARS = (, table-name) or CHARS = (table-name„table-name). 



Subparameter Definition 



table-name 

Names a character-arrangement table. Each table-name is 1 through 4 alphanumeric or 
national characters. Code from one to four names. 

DUIMP 

Requests a high-density dump of 204-character print lines from a 3800. If more than one 
table-name is coded, DUIVIP must be first. 

Note: DUIVIP is valid only on a SYSABEND or SYSUDUIVIP DD statement. 
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Defaults 



If you do not code the DD CHARS parameter, JES uses the following, in order: 

1 . The CHARS parameter on an OUTPUT JCL statement, if referenced by the DD 
statement. 

2. The DD UCS parameter value, if coded. 

3. The UCS parameter on an OUTPUT JCL statement, if referenced. 

If no character-arrangement table is specified on the DD or OUTPUT JCL statements, JES 
uses an installation default specified at initialization. 



Overrides 



A CHARS parameters on a sysout DD statement overrides the OUTPUT JCL CHARS 
parameter. 

For a data set scheduled to the Print Services Facihty (PSF), the PSF uses the following 
parameters, in override order, to select the font list: 

1 . Font list in the library member specified by an OUTPUT JCL PAGEDEF parameter. 

2. DD CHARS parameter. 

3. OUTPUT JCL CHARS parameter. 

4. DD UCS parameter. 

5. OUTPUT JCL UCS parameter. 

6. JES installation default for the device. 

7. Font Hst on the PAGEDEF parameter in the PSF cataloged procedure. 
See "PAGEDEF Parameter" on page 17-48 for more information. 

Relationship to Other Parameters 

Do not code the following parameters with the CHARS parameter. 

* DLM MSVGP 

AMP DSID PROTECT 

DATA DSNAME QNAME 

DDNAME DYNAM VOLUME 

DISP LABEL 
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Relationship to Other Control Statements 

CHARS can also be coded on the following: 

• The OUTPUT JCL statement. 

• The JES3 //*FORMAT PR statement. 

• The JES2 /*OUTPUT statement. 

Printing Device Reassignment 

The output device might not be a 3800, for example, if printing were reassigned to a 321 1. See 
the 3800 Printing Subsystem Programmer's Guide for restrictions that apply. 

Requesting a High-Density Dump 

You can request a high-density dump on the 3800 through two parameters on the DD 
statement for the dump data set or on an OUTPUT JCL statement referenced by the dump DD 
statement: 

• FCB = STD3. This parameter produces dump output at 8 hnes per inch. 

• CHARS = DUMP. This parameter produces 204-character print lines. 

You can code one or both of these parameters. You can place both on the same statement or 
one on each statement. 

Examples of the CHARS Parameter 

//DDl DD SYSOUT=A,CHARS=(GS10,GU12) 

In this example, the CHARS parameter specifies two character-arrangement tables to be used 
when printing the data set: GSIO and GUI 2. 

//SYSABEND DD UNIT=3800,CHARS=DUMP ,FCB=STD3 

The CHARS parameter on this SYSABEND DD statement specifies a high-density dump with 
204 characters per Une. The FCB parameter requests the dump output at 8 lines per inch. 
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CHKPT Parameter 



Parameter Type: Keyword, optional 

Purpose: Use the CHKPT parameter to request that a checkpoint be written when each 
end-of-volume is reached on the multivolume data set defined by this DD statement. 
Checkpoints are written for all volumes except the last. Checkpoints can be requested for input 
or output data sets. 

Note: CHKPT is supported only for multivolume QSAM or BSAM data sets. CHKPT is 
ignored for single-volume QSAM or BSAM data sets or for ISAM, BDAM, BPAM, or VSAM 
data sets. 

References For more information, see CheckpointI Restart User's Guide. 

Syntax: 



CHKPT=EOV 



Subparameter Definition 
EOV 



Requests a checkpoint at each end-of-volume. 



Overrides 



• The RD parameter values of NC and RNC on the JOB or EXEC statements override the 
CHKPT parameter. 

• The CHKPT parameter overrides cataloged procedure values or START command values 
for checkpoints at end-of-volume. 

Relationship to Other Parameters 

Do not code the following parameters with the CHKPT parameter. 

* DLM QNAME 

DATA DYNAM SYSOUT 

DDNAME OUTLIM 

DISP OUTPUT 

Relationship to the SYSCKEOV DD Statement 

If you specify CHKPT, you must also provide a SYSCKEOV DD statement in the job or step. 
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Checkpointing Concatenated Data Sets 

For concatenated BSAM or QSAM data sets, CHKPT must be coded on each DD statement in 
the concatenation, if checkpointing is desired for each data set in the concatenation. 

Examples of the CHKPT Parameter 



//DSl DD DSNAME=INDS,DISP=OLD,CHKPT=EOV, 

// UNIT=SYSSQ , VOLUME=SER= ( TAPEO 1 , TAPE02 , TAPE03 ) 

In this example, the DD statement defines data set INDS, a multivolume QSAM or BSAM 
data set for which a checkpoint is to be written twice: once when end-of-volume is reached on 
TAPEO 1 and once when end-of-volume is reached on TAPE02. 

//DS2 DD DSNAME=OUTDS, DISP=( NEW, KEEP ) , 
// CHKPT=EOV , UNIT=SYSDA , VOLUME= { , , , , 8 ) 

In this example, OUTDS is a multivolume data set that is being created. The data set requires 
eight volumes. Seven checkpoints will be written: when the end-of-volume is reached on 
volumes one through seven. 
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CNTL Parameter 



Parameter Type: Keyword, optional 

Purpose: Use the CNTL parameter to reference a CNTL statement that appears earlier in the 
job. The reference causes the subsystem to execute the program control statements within the 
referenced CNTL/ENDCNTL group. 

The system searches for an earlier CNTL statement with a label that matches the label in the 
CNTL parameter. If the system finds no match, the system issues an error message. 

Syntax: 



CNTL= 


*. label 

* . stepname . label 

* . stepname .procstepname . label 





Subparameter Definition 

*.label 

Identifies an earlier CNTL statement, named label. The system searches for the CNTL 
statement first eariier in this step, then before the first EXEC statement of the job. 

*.stepname.label 

Identifies an earher CNTL statement, named label, that appears in an eariier step, 
stepname, in the same job. 

*.stepname.procstepname.label 

Identifies a CNTL statement, named label, in a cataloged or in-stream procedure. 
Stepname is the name of the job step that calls the procedure; procstepname is the name 
of the procedure step that contains the CNTL statement named label. 

Examples of the CNTL Parameter 



//MONDAY DD CNTL=* . WKLYPGM 

In this example, the DD statement requests that the system use the program control statements 
following the CNTL statement named WKLYPGM and located eariier in this step or preceding 
the first step. 

//TUESDAY DD CNTL=* . SECOND. BLOCKS 

In this example, the DD statement requests that the system use the program control statements 
following the CNTL statement named BLOCKS and located in a preceding step named 
SECOND. 
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//WEDNES DD CNTL=* . THIRD. PROCTWO . CANETTI 

In this example, the DD statement requests that the system use the program control statements 
following the CNTL statement named CANETTI and located in the procedure step 
PROCTWO of the procedure called in the preceding job step THIRD. 
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COPIES Parameter 



Parameter Type: Keyword, optional 

Purpose: Use the COPIES parameter to specify how many copies of this sysout data set are to 
be printed. The printed output is in page sequence for each copy. 

For printing on a 3800 Printing Subsystem, this parameter can instead specify how many copies 
of each page are to be printed before the next page is printed. 

Syntax: 



COPIES= 



nnn 



( nnn , ( group-value [ , group-value ] . . . ) 
( , ( group-value [ , group-value] . . . ) ) 



# You can omit the parentheses if you code only COPIES = nnn. 

# The following are not valid: 

- A null group-value, for example, COPIES = (5,(,)) or COPIES = (5,) 

- A zero group-value, for example, COPIES = (5,(1,0,4)) 

- A null within a Hst of group-values, for example, COPIES = (5,(1 „4)) 



Subparameter Definition 



nnn 

Specifies how many copies of the data set are to be printed; each copy will be in page 
sequence order, nnn is a number from 1 through 255 in a JES2 system and from 1 
through 254 in a JES3 system 

For a data set printed on a 3800, JES ignores nnn if any group-values are specified. 

group-value 

Specifies how many copies of each page are to be printed before the next page is printed. 
Each group-value is a number from 1 through 255 in a JES2 system and from 1 through 
254 in a JES3 system. You can code a maximum of eight group-values. Their sum must 
not exceed 255 or 254. The total copies of each page equals the sum of the group-values. 

Note: 

• This subparameter is vaHd only for 3800 output. 

# For 3800 output, this subparameter overrides an nnn subparameter, if coded. 



Chapter 10, DD Statement 10-31 



DD: COPIES 

Defaults 



If you do not code a COPIES parameter on any of the following, code it incorrectly, or code 
COPIES = 0, the system uses a default of 1, which is the default for the DD COPIES parameter. 

DD statement 

OUTPUT JCL statement 

For JES2, the /*OUTPUT statement 



Overrides 



A COPIES parameter on a sysout DD statement overrides an OUTPUT JCL COPIES 
parameter. 

If this DD statement references an OUTPUT JCL statement and that OUTPUT JCL statement 
contains a FORMDEF parameter, which specifies a hbrary member, the COPYGROUP 
parameter on a FORMDEF statement in that member overrides any group-value 
subparameters on the OUTPUT JCL COPIES parameter or the sysout DD COPIES parameter. 
For more information, see "FORMDEF Parameter" on page 17-36. 

Relationship to Other Parameters 

Do not code the following parameters with the COPIES parameter. 



* 


DISP 


LABEL 


AMP 


DLM 


MSVGP 


DATA 


DSNAME 


QNAME 


DDNAME 


DYNAM 


VOLUME 



Relationship to FLASH Parameter: If this DD statement or a referenced OUTPUT JCL 
statement also contains a FLASH parameter, JES prints with the forms overlay the number of 
copies specified in one of the following: 

• COPIES = nnn, if the FLASH count is larger than nnn. For example, if COPIES =10 and 
FLASH = (LTHD, 12) JES prints 10 copies, all with the forms overlay. 

• The sum of the group-values specified in the COPIES parameter, if the FLASH count is 
larger than the sum. For example, if COPIES = (,(2,3,4)) and FLASH = (LTHD, 12) JES 
prints nine copies in groups, all with the forms overlay. 

• The count subparameter in the FLASH parameter, if the FLASH count is smaller than nnn 
or the sum from the COPIES parameter. For example, if COPIES = 10 and 

FLASH = (LTHD,7) JES prints seven copies with the forms overlay and three copies 
without. 
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Restriction When Coding UNIT Parameter: The COPIES parameter is normally coded with the 
SYSOUT parameter. If, however, both COPIES and UNIT appear on a DD statement, JES 
handles the COPIES parameter as follows: 

• nnn defaults to 1. 

• Only the first group-value is used, if group-values are specified and printing is on a 3800. 

Relationship to Other Control Statements 

The number of copies can also be specified on the COPIES parameter of the following: 

• The OUTPUT JCL statement. 

• The JES2 /*OUTPUT statement. 

• The JES3 //*FORMAT PR statement. 

• The JES3 //*FORMAT PU statement. 

For JES2, if you request copies of the entire job on the JES2 /*JOBPARM COPIES parameter 
and also copies of the data set on the DD COPIES or OUTPUT JCL COPIES parameter, and 
if this is a sysout data set, JES2 prints the number of copies equal to the product of the two 
requests. 

Using OUTPUT JCL COPIES by NulUfying DD Copies 

If both a DD statement and a referenced OUTPUT JCL statement contain COPIES 
parameters, the DD COPIES parameter normally overrides the OUTPUT JCL COPIES 
parameter. For example, four copies are printed of sysout data set DDA: 

//OTA OUTPUT C0PIES=3 

//DDA DD SYS0UT=A,0UTPUT=*.0TA,C0PIES=4 

However, if the DD COPIES is a null parameter, the OUTPUT JCL COPIES parameter is 
used. For example, three copies are printed of sysout data set DDB: 

//0TB OUTPUT C0PIES=3 

//DDB DD SYSOUT=A,OUTPUT=*.OTB,COPIES= 

The following example shows a null COPIES parameter on an in-stream DD statement that 
overrides a procedure DD statement. The null COPIES parameter on DD statement PS. DDA 
nullifies the COPIES parameter on the procedure DD statement DDA, thereby allowing the 
COPIES parameter on OUTPUT JCL statement OT to be used. The system prints three copies 
of the DDA sysout data set. 

//JEX JOB ACCT3 4, 'PAUL BENNETT' 

//INSTR PROC 

//PS EXEC PGM=ABC 

//OT OUTPUT C0PIES=3 

//DDA DD SYSOUT=A,OUTPUT=*.0T,COPIES=2 

// PEND 

//STEPl EXEC PROC=INSTR 

//PS. DDA DD COPIES= 



/ 



* 



Note: If a null COPIES parameter appears on a DD statement that either does not reference an 
OUTPUT JCL statement or references an OUTPUT JCL statement that does not contain a 
COPIES parameter, the system uses a default of 1 . 
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Examples of the COPIES Parameter 



//RECORDl DD SYSOUT=A, COPIES=32 

This example requests 32 copies of the data set defined by DD statement RECORDl when 
printing on an impact printer or a 3800. 

//REC0RD2 DD SYSOUT=A,COPIES= ( , ( 1 , 2 ) ) 

In this example, when printing on a 3800, three copies of the data set are printed in two groups. 
The first group contains one copy of each page. The second group contains two copies of each 
page. When printing on an impact printer, one copy (the default for nnn) is printed. 

//RECORDS DD SYSOUT=A,COPIES= ( 8 , ( 1 , 3 , 2 ) ) 

In this example, when printing on a 3800, six copies of the data set are printed in three groups. 
The first group contains one copy of each page, the second group contains three copies of each 
page, and the last group contains two copies of each page. When the output device is not a 
3800, the system prints eight collated copies. 

//REC0RD4 DD UNIT=3800 , COPIES= (1,(2,3)) 

Because the UNIT parameter is coded and the device is a 3800, the system prints only the first 
group-value: two copies of each page. 
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DATA Parameter 



Parameter Type: Positional, optional 

Purpose: Use the DATA parameter to begin an in-stream data set that contains statements 
with // in columns 1 and 2. The data records immediately follow the DD DATA statement; the 
records must be in BCD or EBCDIC. The data records end when one of the following is 
found: 

/* in the input stream 

The two-character delimiter specified by a DLM parameter on this DD statement 

The input stream runs out of card images 

Note that, unlike a DD * statement, the data is not ended by the // that indicates another JCL 
statement. 

Syntax: 



//ddname DD DATA [, parameter] .. . [comments] 



Defaults 



When you do not code DCB = BLKSIZE and DCB = LRECL, JES uses installation defaults 
specified at initialization. 

Relationship to Other Parameters 

Restrictions in a JES2 System: For JES2, the only DD parameters that you can code with the 
DATA parameter follow. All other parameters are a JCL error. 

DCB 
DLIVI 
DSID 
VOLUIVIE 

Restrictions in a JES3 System: For JES3, the only DD parameters that you can code with the 
DATA parameter follow. All other parameters are a JCL error. 

DCB = BLKSIZE 

DCB=BUFNO 

DCB = LRECL 

DCB = MODE = C 

DLIVL 

DSID 

VOLUME = SER 
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For 3540 Diskette Input /Output Units: VOLUME = SER, DCB = BUFNO, and DSID 

parameters on a DD DATA statement are ignored except when they are detected by a diskette 
reader as a request for an associated data set. See IBM 3540 Programmer' s Reference. On a 
DD * or DD DATA statement processed by a diskette reader, you can specify DSID and 
VOLUME = SER parameters to indicate that a diskette data set is to be merged into the input 
stream following the DD statement. 

Relationship to Other Control Statements 

Do not refer to an earlier DD DATA statement in DCB, DSNAME, or VOLUME parameters 
on following DD statements. 

Location in the JCL 

A DD DATA statement begins an in-stream data set. 

In-stream Data for Cataloged or In-stream Procedures: A cataloged or in-stream procedure 
cannot contain a DD DATA statement. When you call a procedure, you can add input stream 
data to a procedure step by placing in the calling step one or more DD * or DD DATA 
statements, each followed by data. 

Multiple In-stream Data Sets for a Step: You can code more than one DD * or DD DATA 

statement in a job step in order to include several distinct groups of data for the processing 
program. Precede each group with a DD * or DD DATA statement and follow each group 
with a delimiter statement. If you omit a DD statement before and a delimiter after input data, 
the system provides a DD * statement with the ddname of SYSIN and ends the data when it 
reads a JCL statement or runs out of card images. 

Unread Records 

If the processing program does not read all the data in an in-stream data set, the system skips 
the remaining data without abnormally terminating the step. 



Examples of the DATA Parameter 



//GROUP 1 DD DATA 

data 

/* 

//GROUP 2 DD DATA 

data 
/* 
This example defines two groups of data in the input stream. 
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//STEP2 EXEC PROC=UPDATE 

//PREP.DD4 DD DSNAME=A.B . C ,UNIT=3350 , VOLUME=SER=D88230 , 
// SPACE= ( TRK ,(10,5)), DISP= ( , CATLG , DELETE ) 

//PREP. INI DD DATA 



data 



/* 
//ADD.IN2 



DD 



/-' 



data 



This example defines two groups of data in the input stream. The input defined by DD 
statement PREP. INI is to be used by the cataloged procedure step named PREP. This data 
contains job control statements. The input data defined by DD statement ADD.IN2 is to be 
used by the cataloged procedure step named ADD. Because this data is defined by a DD * 
statement, it must not contain job control statements. 
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DCB Parameter 



Parameter Type: Keyword, optional 

Purpose: Use the DCB parameter to complete during execution the information in the data 
control block (DCB) for a data set. 

The data control block is constructed by the DCB macro instruction in assembler language 
programs or by file definition statements or language-defined defaults in programs in other 
languages. 

References: For more information on constructing the data control block, see Data 
Administration Guide. 

Syntax: 



DCB=(subparameter [ ,subparameter] . . . ) 



DCB= 



dsname 

* . ddname 

* . stepname . ddname 

*. St epname .procstepname . ddname 



[ ,subparameter] . . . 



Parentheses: You can omit the parentheses if you code: 

• Only one keyword subparameter. 

• Only a data set name, dsname, without any subparameters. 

• Only a backward reference without any subparameters. A backward reference is a reference to an 
earlier DD statement in the job or in a cataloged or in-stream procedure called by a job step. A 
backward reference is in the form *. ddname or *. stepname. ddname or 

* .stepname.procstepname.ddname. 

For example, DCB = RECFM = FB or DCB = WKDATA or DCB = *.STEP3.DD2 

Multiple Subparameters: When the parameter contains more than one subparameter, separate the 
subparameters by commas and enclose the subparameter list in parentheses. For example, 
DCB == (RECFM = FB,LRECL = 133,BLKSIZE = 399) or DCB = (*.DDl,BUFNO = 4) 

Continuation onto Another Statement: Enclose the subparameter list in only one set of parentheses. End 
each statement with a comma after a complete subparameter. For example: 

//INPUT DD DSN=WKDATA,DCB=(RECFM=FB,LRECL=80,BLKSIZE=800, 
// BUFL=800,BUFNO=4) 
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Subparameter Definition 



subparameter 

Specifies a DCB keyword subparameter needed to complete the data control block. An 
alphabetic summary of the DCB keyword subparameters follows this parameter 
description. 

You must supply DCB information through the DCB subparameters if your processing 
program, the data set label, or your language's defined values do not complete the data 
control block. 

dsname 

Names a cataloged data set. The system is to copy DCB information from the data set's 
label. The data set must reside on a direct access volume, and the volume must be 
mounted before the job step is executed. 

The dsname cannot contain special characters, except for periods used in qualifying the 
name. Do not specify a generation data group (GDG) name. 

The system copies the following DCB information from the data set label: 

DSORG (used in a backward reference) 

RECFM 

OPTCD 

BLKSIZE 

LRECL 

KEYLEN 

RKP 

If you do not specify the volume sequence number, system code, and expiration date of 
the cataloged data set, the system copies them from the data set label. 

If you code any DCB subparameters after the dsname, these subparameters override the 
corresponding subparameters in the data set label. The system copies from the referenced 
label only those subparameters not specified on the referencing DD statement. 

*.ddname 

*.stepname.ddnaine 

*.stepnaine.procstepname.ddname 

Specify a backward reference to an earlier DD statement. The system is to copy DCB 
information from that DD statement. The DCB parameter of the referenced DD 
statement must contain subparameters; it cannot name a cataloged data set or refer to 
another DD statement. 

*.ddname specifies the ddname of an earlier DD statement in the same step. 
*.stepname.ddname specifies the ddname of a DD statement in an earlier step, stepname, 
in the same job. *.stepname.procstepname.ddname specifies the ddname of a DD DD 
statement in a cataloged or in-stream procedure called by an earlier job step. Stepname is 
the name of the job step that calls the procedure and procstepname is the name of the 
procedure step that contains the DD statement. 

If you code any DCB subparameters after the reference, these subparameters override the 
corresponding subparameters on the referenced DD statement. The system copies from 
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the referenced DD statement only those subparameters not specified on the referencing 
DD statement. 

Do not reference a DD * or a DD DATA statement. 

Note: The system also copies the UCS and FCB parameters from the referenced DD 
statement, unless you override them in the referencing DD statement. 

Completing the Data Control Block 

The system obtains data control block information from the following sources, in override 
order: 

• The processing program, that is, the DCB macro instruction in assembler language 
programs or file definition statements or language-defined defaults in programs in other 
languages. 

• The DCB subparameter of the DD statement. 

• The data set label. 

Therefore, if you supply information for the same DCB field in your processing program and 
on a DD statement, the system ignores the DD DCB subparameter. If a DD statement and the 
data set label supply information for the same DCB field, the system ignores the data set label 
information. 

Relationship to Other Parameters 

Do not code the following parameters with the DCB parameter. 

AMP 
DYNAM 

With the DDNAME parameter, code only the BLKSIZE, BUFNO, and DIAGNS DCB 

subparameters. 

The following are also mutually exclusive: 

DCB 

Subparameter Mutually Exclusive With 

CPRI DD parameter OUTLIM 

FUNC Data-set-sequence-number of the DD LABEL parameter 

THRESH DD parameter OUTLIM 

Mutually Exclusive DCB Subparameters: The DCB subparameters KEYLEN, MODE, PRTSP, 
STACK, and TRTCH apply to different device types; because only one can apply to a data 
set, they use the same DCB field. If one of these subparameters is specified on a DD statement 
for a device different from the type to which it applies, the system interprets the value 
incorrectly. 

DCB subparameters CPRI and THRESH are mutually exclusive. 
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For 3540 Diskette Inputl Output Units: The VOLUME = SER, DCB = BUFNO, and DSID 

parameters on a DD * or DD DATA statement are ignored except when they are detected by a 
diskette reader as a request for an associated data set. See IBM 3540 Programmer's Reference. 



Examples of the DCB Parameter 



//DD2 


DD 


// 




//DD3 


DD 


// 





//DDl DD DSNAME=ALP,DISP=( ,KEEP) ,VOLUME=SER=44321, 

// UNIT=3400-6,DCB=(RECFM=FB,LRECL=240,BLKSIZE=960, 

// DEN=1,TRTCH=C) 

DD statement DDl defines a new data set named ALP. The DCB parameter contains the 
information necessary to complete the data control block. 

DSNAME=BAL , DISP=OLD , DCB= ( RECFM=F , LRECL=80 , 

BLKSIZE=80) 

DSNAME=CNANN,DISP=( , CATLG, DELETE ) ,UNIT=3400-6 , 

LABEL=( ,NL) , VOLUME=SER=663488 , DCB=* . DD2 

DD statement DD3 defines a new data set named CNANN and requests that the system copy 
the DCB subparameters from DD statement DD2, which is in the same job step. 

//DD4 DD DSNAME=JST,DISP=(NEW,KEEP) ,UNIT=3350, 

// SPACE=(CYL, (12,2) ) ,DCB= (A.B . C,KEYLEN=8) 

DD statement DD4 defines a new data set named JST and requests that the system copy the 
DCB information from the data set label of the cataloged data set named A. B.C. If the data 
set label contains a key length specification, it is overridden by the KEYLEN coded on this DD 
statement. 

//DD5 DD DSNAME=SMAE,DISP=OLD, 

// DCB= ( * . STEP 1 . PR0CSTP5 . DD8 , BUFN0=5 ) 

DD statement DD5 defines an existing, cataloged data set named SMAE and requests that the 
system copy DCB subparameters from DD statement DD8, which is contained in the procedure 
step named PR0CSTP5. The cataloged procedure is called by EXEC statement STEPl. Any 
of the DCB subparameters coded on DD statement DD8 are ignored if they are specified in the 
program. If the DCB BUFNO subparameter is not specified in the program, five buffers are 
assigned. 
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Description of Subparameters 


BFALN 


X 


X 


X 


X 




X 




X 


X 




BFALN = {F|D} 

Specifies that each buffer starts either on a word boundary that is not also a 
doubleword boundary or on a doubleword boundary. If both BFALN and 
BFTEK are specified, they must be specified from the same source. 

Default: D (doubleword) 


BFTEK 


X 






X 


X 








X 




BFTEK = R for BDAM and BSAM 
BFTEK = D for BTAM 

BFTEK = {S|E|A} for QSAM 

R Specifies that the data set is being created for or contains variable-length 

spanned records. 
D Specifies that dynamic buffering is to be used in the processing program; if 

dynamic buffering is specified, a buffer pool must also be defined. 
S, E, and A 

Specify simple, exchange, or locate mode logical record interface for 

spanned records. S, E, or A can be coded only when RECFM = VS. 

If both BFALN and BFTEK are specified, they must be specified from the same 
source. 


BLKSIZE 


X 




X 


X 




X 




X 


X 


X 


BLKSIZE = bytes 

Specifies the maximum length, in bytes, of a block. The maximum is 32760. The 
number you specify for BLKSIZE depends on the device tj^pe and the record 
format for the data set. For ASCII data sets on magnetic tape, the minimum 
value for BLKSIZE is 18 bytes and the maximum is 2048 bytes. If you code the 
BLKSIZE subparameter in the DCB macro instruction or on a DD statement 
that defines an existing data set with standard labels, the DCB BLKSIZE 
overrides the block size specified in the label. BLKSIZE can be coded but will 
have no effect on EXCP processing. 


BUFIN 




















X 


BUFIN = buffers 

Specifies the number of buffers to be assigned initially for receiving operations for 
each line in the line group. The combined BUFIN and BUFOUT values must 
not be greater than the number of buffers in the buffer pool for this line group 
(not including those for disk activity only). 

Default: 1 


BUFL 


X 


X 


X 


X 




X 




X 


X 


X 


BUFL = bytes 

Specifies the length, in bytes, of each buffer in the buffer pool. The maximum is 
32760. 


BUFMAX 




















X 


BUFMAX = buffers 

Specifies the maximum number of buffers to be allocated to a line at one time. 
Number must be 2 through 15 and must be equal to or greater than the larger of 
the numbers specified by the BUFIN and BUFOUT subparameters. 

Default: 2 
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BUFNO 


X 


X 


X 


X 


X 


X 




X 


X 




BUFNO = buffers 

Specifies the number of buffers to be assigned to the DCB. The maximum 
normally is 255, but can be less because of the size of the region. 


BUFOFF 








X 










X 




BUFOFF = {n|L} 

n Specifies the length, in bytes, of the block prefix used with an ASCII tape 
data set. For input, n can be through 99. For output, n must be for 
writing an output data set with fixed-length or undefined-length records. 

L Specifies that the block prefix is 4 bytes and contains the block length. 
BUFOFF = L is valid only with RECFM = D. For output, only 
BUFOFF = Lis valid. 


BUFOUT 




















X 


BUFOUT = buffers 

Specifies the number of buffers to be assigned initially for sending operations for 
each line in the line group. The combined number of BUFIN and BUFOUT 
values must not be greater than the number of buffers in the buffer pool for this 
line group (not including those for disk activity only) and cannot exceed 15. 

Default: 2 


BUFSIZE 




















X 


BUFSIZE = bytes 

Specifies the length, in bytes, of each of the buffers to be used for all lines in a 
particular line group. Length must be 31 through 65535 bytes. 


CPRI 




















X 


CPRI = {R|E|S} 

Specifies the relative transmission priority assigned to the lines in this line group. 
R Specifies that processor receiving has priority over processor sending. 
E Specifies that receiving and sending have equal priority. 
S Specifies that processor sending has priority over processor receiving. 

Note: Subparameter CPRI is mutually exclusive with subparameter THRESH 
and with DD parameter OUTLIM. 
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CYLOFL 



CyLOFL = tracks 



Specifies the number of tracks on each cyhnder to hold the records that overflow 
from other tracks on that cylinder. The maximum is 99. 



Specify CYLOFL only when OPTCD = Y. 



DEN 



X 



DEN = {li2|3|4} 

Specifies the magnetic density, in number of bytes-per-inch, used to write a 
magnetic tape data set. 



DEN 


7-track tape 


9-track tape 


1 

2 
3 
4 


556 
800 


800 (NRZI) 
1600 (PE) 
6250 (GCR) 



NRZI Non-return-to-zero inverted recording mode. 
PE Phase encoded recording mode. 
GCR Group coded recording mode. 
Default: 800 bpi assumed for 7-track tape and 9-track without dual density. 
1600 bpi assumed for 9-track with dual density or phase-encoded 

drives. 
6250 bpi assumed for 9-track with 6250/1600 bpi dual density or group 
coded recording tape. 



DIAGNS 



X 



X 



X 



X 



X 



X 



X 



DIAGNS = TRACE 

Specifies the OPEN/CLOSE/EOV trace option, which gives a 
module-by-module trace of OPEN/CLOSE/EOV's work area and the DCB. If 
the generalized trace facility (GFT) is not running and tracing user events, 
DIAGNS is ignored. 



DSORG 



X 



X 



X 



X 



X 



X 



X 



DSORG = organization 

Specifies the organization of the data set and indicates whether the data set 
contains any location-dependent information that would make the data set 
unmovable. 



Organization 



PS Physical sequential data set 



PSU Physical sequential data set that con- 
tains location-dependent information 



DA Direct access data set 



DAU Direct access data set that contains 
location-dependent information 



IS Indexed sequential data set 



ISU Indexed sequential data set that con- 
tains location-dependent information 



PO Partitioned data set 



POU Partitioned data set that contains 
location-dependent information 



CX Communications line group 



GS Graphic data control block 



Access Method 



BSAM,EXCP,QSAM,TCAM 



BSAM,QSAM,EXCP 



BDAM,EXCP 



BDAM,EXCP 



BISAM,QISAM,EXCP 



QISAM,EXCP 



BPAM,EXCP 



BPAM,EXCP 



BTAM 



GAM 
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Description of Subparameters 


EROPT 










X 








X 




EROPT -X 

BTAM: Requests the BTAM on-line terminal test option. 
x = T 

QSAM: Specifies the option to be executed if an error occurs in reading 
or writing a record. 
X = ACC System is to accept the block causing the error. 

SKP System is to skip the block causing the error. 

ABE System is to cause abnormal end of task. 
Default: ABE 


FUNC 








X 










X 




FUNC = {I|R|P|W|D|X|T) 

Specifies the type of data set to be opened for a 3505 Card Reader or 3525 Card 
Punch. Unpredictable results will occur if coded for other than a 3505 or 3525. 

Note: Subparameter FUNC is mutually exclusive with the 
data-set-sequence-number of the DD LABEL parameter. 

I Data set is for punching and printing cards. 

R Data set is for reading cards. 

P Data set is for punching cards. 

W Data set is for printing. 

D Protected data set is for punching. 

X Data set is for both punching and printing. 

T Two-line print option. 

Default: P, for output data set. R, for input data set. 

The only valid combinations of these values are: 
I WT RWT RPWXT PWX 
R RP PW RPWD RPWX 
P RPD PWXT RWX RWX 
W RW RPW RWXT 


GNCF 














X 








GNCP=n 

Specifies the maximum number of I/O macro instructions that the program will 
issue before a WAIT macro instruction. 


INTVL 




















X 


INTVL = {n|0} 

Specifies the interval, in seconds, between passes through an invitation list. 
Default: 


IPLTXID 




















X 


IPLTXID = member 

Specifies the name of the partitioned data set member that you want loaded into a 
3704/3705 Communications Controller. The DCB IPLTXID subparameter 
overrides IPLTXID in the TERMINAL macro representing the NCP. 
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KEYLEN 


X 




X 


X 




X 




X 




X 


KEYLEN = bytes 

Specifies the length, in bytes, of the keys used in a data set. The number is from 
1 through 255. KEYLEN = specified in the DCB parameter is ignored. For an 
existing data set, the key length can be supplied from the data set label. If a key 
length is not specified or supplied, input or output requests must not require keys. 
The subparameters KEYLEN, MODE, PRTSP, STACK, and TRTCH are 
mutually exclusive. 


LIMCT 


X 




















LIMCT = {blocks 1 tracks} 

Specifies how many blocks (if relative block addressing is used) or how many 
tracks (if relative track addressing is used) are to be searched for a free block or 
available space. This kind of search occurs only when DCB OPTCD = E is also 
specified; otherwise, LIMCT is ignored. If the LIMCT number equals or exceeds 
the number of blocks or tracks in the data set, the entire data set is searched. 


LRECL 






X 


X 




X 




X 


X 


X 


LRECL = bytes 

Specifies (1) the length, in bytes, for fixed-length records or (2) the maximum 
length, in bytes, for variable-length records. When the DCB RECFM is F or U, 
the length must not exceed the DCB BLKSIZE. For RECFM = D or V, the 
length must not exceed BLKSIZE minus 4. For RECFM = VS, the length can 
exceed BLKSIZE. For unblocked records when DCB RKP = 0, the length is for 
only the data portion of the record. 

LRECL = nnnnnK 

Specifies the length in kilobytes for variable-length spanned records in 
ISO/ANSI/FIPS Version 3 tape data sets that are processed the Data Facihty 
Product using the extended logical record interface (XLRI). nnnnn is from 1 
through 16383 and indicates multiples of 1024 bytes. The value in the DCB must 
be LRECL = OK or LRECL = nnnnnK. If a K is coded for any other type of data 
set, only the numeric value of LRECL is recognized. 

QSAM: LRECL = X 

Specifies that the logical record length exceeds 32760 bytes for variable-length 
spanned records. This option is not valid for ISO/ANSI/FIPS Version 3 
variable-length records. 
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Description of Subparameters 


MODE 








X 




X 






X 




c[ol 

MODE= E [rJ 

Specifies the mode of operation to be used with a card reader, a card punch, or a 
card read-punch. 

C Card image (column binary) mode 

E EBCDIC mode 

Optional mark read mode 

R Read column eliminate mode 

If you specify R, you must also specify either C or E. Do not code the MODE 
subparameter for data entered through the input stream except in a JES3 system. 
The subparameters KEYLEN, MODE, PRTSP, STACK, and TRTCH are 
mutually exclusive. 

Do not code MODE = C for JES2 or JES3 output. 

Default: E 


NCP 




X 


X 


X 














NCP = n 

Specifies the maximum number of READ or WRITE macro instructions that will 
be issued before a CHECK macro instruction is issued to test for completion of 
the I/O operation. The maximum number is 99, but may actually be smaller 
depending on the size of the region or partition. If chained scheduling is used, 
the number must be greater than 1. 

Default: 1 


NTM 
















X 






NTM = tracks 

Specifies the number of tracks to be used for a cylinder index. When the specified 
number of tracks has been filled, a master index is created. The DCB NTM is 
needed only when the DCB OPTCB = M. If you specify OPTCD = M but omit 
NTM, the master index option is ignored. 
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OPTCD 



X 



Specifies the optional services to be performed by the control program. All 
optional services must be requested in one source, that is, in the data set label of 
an existing data set, in the DCB macro, or in the DD DCB parameter. However, 
the processing program can modify the DCB OPTCD field. Code the characters 
in any order; when coding more than one, do not code commas between the 
characters. 



BDAM: OPTCD = 

A 



.[E][F][W] 

indicates that the actual device addresses are to be specified in READ and 

WRITE macro instructions. 
R indicates that relative block addresses are to be specified in READ and 

WRITE macro instructions. 
E indicates that an extended search (more than one track) is to be performed 

for a block of available space. LIMCT must also be coded. Do not code 

LIMCT = because it will cause an abnormal termination when a READ or 

WRITE macro instruction is executed. 
F indicates that feedback can be requested in READ and WRITE macro 

instructions and the device is to be identified in the same form as it was 

presented to the control program. 
W requests a validity check for write operaUons on direct access devices and 

the IBM 3480 Magnetic Tape Subsystem. 



BISAM: OPTCD = {[L][R][W]} 

L requests that the control program delete records that have a first byte of all 
ones. These records will be deleted when space is required for new records. 
To use the delete option, the DCB RKP must be greater than zero for 
fixed-length records and greater than four for variable-length records. 

R requests that the control program place reorganization criteria information 
in certain fields of the DCB. The problem program can analyze these 
statistics to determine when to reorganize the data set. 

W requests a validity check for write operations on direct access devices. 



Default: R, whenever the OPTCD subparameter is omitted from all sources. 



BPAM: OPTCD = fC|W|CW 
C|H|HC 
C|WH|WHC 

C requests chained scheduling. 

W requests a validity check for write operations on direct access devices. 

H requests that a parfitioned data set being processed and residing on MSS, if 

opening for input, is to be staged to end of file (EOF) on the virtual 

DASD. Otherwise, only the directory is staged. 
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OPTCD 

(continued) 



BSAM and QSAM: OPTCD ^ 



\ 



/B 

T 

U[C] 

C[T][B][U] 
H[Z][B] 
J[C][U] 
W[C][T][B][U] 
Z[C][T][B][U] 
Q[C][T][B] 
^Z 

B requests that the end-of-volume (EOV) routine disregard the end-of-file 
(EOF) recognition for magnetic tape. For an input data set on a 
standard-labeled (SL or AL) tape, the EOV routine treats EOF labels as 
EOV labels until the volume serial list is exhausted. This option allows SL 
or AL tapes to be read out of volume sequence or to be concatenated to 
another tape with the same data set name using one DD statement. 

C requests chained scheduling. 

H requests hopper empty exit for optical readers or bypass of DOS checkpoint 
records. 

J for a data set to be printed on a 3800 Printing Subsystem, instructs the 
system that the logical record for each output data line contains a table 
reference character (TRC). The TRC identifies which character 
arrangement table in the CHARS parameter is to be used to print the line, 
Before specifying OPTCD = J, see the 3800 Printing Subsystem 
Programmer's Guide. 

Q requests (1) that ASCII tape records in an input data set be converted to 

EBCDIC code when the input record has been read, or (2) an output record 
in EBCDIC code be converted to ASCII code before the record is written. 

T requests user totaling facility. T cannot be specified for a SYSIN or sysout 
data set. 

U for 1403 or 3211 Printers with the Universal Character Set (UCS) feature 
and for the 3800, permits data checks and allows analysis by an appropriate 
error analysis routine. If U is omitted, data checks are not recognized as 
errors. 

U for MSS, requests window processing to reduce the amount of staging space 
required to process large sequential data sets. The DCB DSORG must be 
PS, the allocation must be in cylinders, and the type of I/O accessing must 
be INPUT only or OUTPUT only. 

W requests a validity check for write operations on direct access devices and 
the IBM 3480 Magnetic Tape Subsystem. 

Z for magnetic tape input, requests that the control program shorten its 
normal error recovery procedure. When specified, a data check is 
considered permanent after five unsuccessful attempts to read a record. 

Z for direct access storage device input, specifies search direct (SD) for 
sequential data sets. 

Z for direct access input, specifies the search direct technique. 



OPTCD = Z is ignored if chained scheduling is used. 



EXCP: OPTCD = Z 

Z for magnetic tape input, requests that the control program shorten its 
normal error recovery procedure. When specified, a data check is 
considered permanent after five unsuccessful attempts to read a record. 

Z for direct access storage device input, specifies search direct (SD) for 

sequential data sets. 
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OPTCD 

(continued) 



QISAM: OPTCD = {[I][L][M][R][U][W][Y]} 

I requests that ISAM use the independent overflow areas for overflow 
records. 

L requests that ISAM delete records that have a first byte of all ones. These 
records can be deleted when space is required for new records. To use the 
delete option, the DCB RKP must be greater than zero for fixed-length 
records and greater than four for variable-length records. 

M requests that the system create and maintain one or more master indexes, 
according to the number of tracks specified in the DCB NTM 
subparameter. 

R requests that the control program place reorganization criteria information 

in the DCB. The problem program can analyze these statistics to determine 

when to reorganize the data set. 
U requests that the system accumulate track index entries in storage and write 

them as a group for each track of the track index. U can be specified only 

for fixed-length records. 
W requests a validity check for write operations on direct access devices. 
Y requests that the system use the cylinder overflow areas for overflow 

records. 



Default: R, whenever the OPTCD subparameter is omitted from all sources. 



TCAM: OPTCD = {C|U|W} 

C specifies that one byte of the work area indicates if a segment of a message 

is the first, middle, or last segment. 
U specifies that the work unit is a message. If U is omitted, the work unit is 

assumed to be a record. 



W 



specifies that the name of each message source is to be placed in an 8-byte 
field in the work area. 



PCI 



PCI = 



f([N][,N])) 

([R][,R]) 

([A][,A]) 
([X][,X]) 



Specifies (1) whether or not a program-controlled interruption (PCI) is to be used 
to control the allocation and freeing of buffers and (2) how these operations are 
to be performed. The first operand applies to receiving operations and the second 
to sending operations. 
N specifies that no PCIs are taken while filling buffers during receiving 

operations or emptying buffers during sending operations. 
R specifies that after the first buffer is filled or emptied, a PCI occurs during 

the filling or emptying of each succeeding buffer. The completed buffer is 

freed, but no new buffer is allocated to take its place. 
A specifies that after the first buffer is filled or emptied, a PCI occurs during 

the filling or emptying of the next buffer. The first buffer is freed, and a 

buffer is allocated to take its place. 
X specifies that after a buffer is filled or emptied, a PCI occurs during the 

filling or emptying of the next buffer. The first buffer is not freed, but a 

new buffer is allocated. 



You can omit the parentheses if you code only the first operand. 
Default: (A,A) 



10-50 MVS/XA JCL Reference 



DD: DCB 



Access 
Method 



Sub- 
Parameters 



a 



Description of Subparameters 



PRTSP 



X 



X 



X 



PRTSP = {0|1|2|3} 



Specifies the line spacing for an online printer. PRTSP is valid only for an online 
printer and only if the DCB RECFM is not A or M. PRTSP ==2 is ignored if 
specified with the DD SYSOUT parameter. The subparameters KEYLEN, 
MODE, PRTSP, STACK, and TRTCH are mutually exclusive. 

spacing is suppressed 

1 single spacing 

2 double spacing 

3 triple spacing 



Default: 1 



JES2 ignores PRTSP for sysout data sets. 



RECFM 



X 



X 



X 



Specifies the format and characteristics of the records in the data set. All the 
format and characteristics must be completely described in one source, that is, in 
the data set label of an existing data set, in the DCB macro, or in the DD DCB 
parameter. However, the processing program can modify the RECFM field in 
the DCB. 



BDAM: RECFM = 



V[S] 
[BS] 
F[T] 



U indicates that the records are of undefined length. 

V indicates that the records are of variable length. 

VS indicates that the records are of variable length and spanned. 

VBS indicates that the records are of variable length, blocked, and spanned, and 

that the problem program must block and segment the records. 

F indicates that the records are of fixed length. 

T indicates that the records may be written using the track-overflow feature. 

Default: undefined-length, unblocked records. 



/U 



BPAM: RECFM = 



m 


rA 




M 


■B 1 


rA 


T 


M 


BT 




■B 1 


rA 


T 


M 


BT 





A indicates that the record contains ISO/ANSI control characters. 

B indicates that the records are blocked. 

F indicates that the records are of fixed length. 

M indicates that the records contain machine code control characters. 

T indicates that the records may be written using the track-overflow feature. 

Chained scheduling (OPTCD = C) will be ignored. 

U indicates that the records are of undefined length. 

V indicates that the records are of variable length. 



Default: U 
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r r^ f;:,i\ 



BSAM,EXCP,& QSAM: RECFM = 



< 



\ 



B 

S 

T 

BS 

BT 

BST 

B 

S 

T 

BS 

BT 

BST 



> 



/ 



For BSAM, EXCP, and QSAM using ISO/ANSI/FIPS data sets on tape: 

' D [B] S " 

D [B] [A] 

RECFM = 1 U [A] 

F [B] [A] 

A or M cannot be specified if the PRTSP subparameter is specified. 

A indicates that the record contains ISO/ANSI device control characters. 

B indicates that the records are blocked. 

D indicates that the records are variable-length ISO/ANSI tape records. 

F indicates that the records are of fixed length. 

M indicates that the records contain machine code control characters. 

S (1) For fixed-length records, indicates that the records are written as 

standard blocks, that is, no truncated blocks or unfilled tracks within the 
data set, with the exception of the last block or track. (2) For 
variable-length records, indicates that a record can span more than one 
block. 

T indicates that the records can be written using the track-overflow feature, if 
required. Chained scheduling (OPTCD = C) is ignored. 

U indicates that the records are of undefined length. U is invalid for an 
ISO/ANSI/FIPS Version 3 tape data set. 

V indicates that the records are of variable length. V cannot be specified for 

(1) a variable-length ISO/ANSI tape data set (specify D for this data set), 

(2) a card reader data set, or (3) a 7-track tape unless the data conversion 
feature (TRTCH = C) is used. 



Default: U for IBM standard label tapes. 



QISAM: RECFM = 



[B] 



B indicates that the records are blocked. 
F indicates that the records are of fixed length. 

V indicates that the records are of variable length; variable records cannot be 
in ASCII. 



When creating indexed sequential data sets, you can code the RECFM 
subparameter; when processing existing indexed sequential data sets, you must 
omit RECFM. 

Default: V 
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RECFM 

(continued) 






















TCAM: RECFM = f U ] 
V[B] 
F J 

B indicates that the records are blocked. 

F indicates that the records are of fixed length. 

U indicates that the records are of undefined length. 

V indicates that the records are of variable length. 

Default: U 


RESERVE 




















X 


RESERVE = (bytes 1, by tes2) 

Specifies the number of bytes (0 through 255) to be reserved in a buffer for 

insertion of data by the DATETIME and SEQUENCE macros. 

bytes 1 indicates the number of bytes to be reserved in the first buffer that 

receives an incoming message. 
bytes2 indicates the number of bytes to be reserved in all the buffers 

following the first buffer in a multiple-buffer header situation. 

Default: (0,0) 


RKP 












X 




X 






RKP = number 

Specifies the position of the first byte of the record key in each logical record. 

The first byte of a logical record is position 0. 

If RKP = is specified for blocked fixed-length records, the key begins in the first 

byte of each record. OPTCD = L must not be specified. 

If RKP = is specified for unblocked fixed-length records, the key is not written 

in the data field. OPTCD = L can be specified. 

For variable-length records, the relative key position must be 4 or greater, if 

OPTCD = L is not specified; the relative key position must be 5 or greater, if 

OPTCD = L is specified. 

Default: 

For EXCP processing, RKP can be coded but is ignored. 


STACK 








X 




X 






X 




STACK = {112} 

Specifies which stacker bin is to receive a card. The subparameters KEYLEN, 
MODE, PRTSP, STACK, and TRTCH are mutually exclusive. 

Default: 1 


THRESH 




















X 


THRESH = nn 

Specifies the percentage of the nonreusable disk message queue records that are to 
be used before a flush closedown occurs. 

Default; Closedown occurs when .95 percent of the records have been used. 

Note: Subparameter THRESH is mutually exclusive with subparameter CPRI 
and with DD parameter OUTLIM. 
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TRTCH 








X 




X 






X 




TRTCH = {C|E|T|ET} 

Specifies the recording technique for 7-track tape. The subparameters KEYLEN, 

MODE, PRTSP, STACK, and TRTCH are mutually exclusive. 

C specifies data conversion, odd parity, and no translation. 

E specifies no data conversion, even parity, and no translation. 

T specifies no data conversion, odd parity, and that BCD to EBCDIC 

translation is required when reading and EBCDIC to BCD translation 

when writing. 
ET specifies no data conversion, even parity, and that BCD to EBCDIC 

translation is required when reading and EBCDIC to BCD translation 

when writing. 

Default: no conversion, odd parity, and no translation. 
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DDNAME Parameter 



Parameter Type: Keyword, optional 

Purpose: Use the DDNAME parameter to postpone defining a data set until later in the same 
job step. A DDNAME parameter on a DD statement in a cataloged or in-stream procedure 
allows you to postpone defining the data set until a job step calls the procedure; the data set 
must be defined in the calHng job step. 

Syntax: 



DDNAME =ddname 



Subparameter Definition 



ddname 

Refers to a later DD statement that defines the data set. ddname must match the ddname 
of the referenced DD statement. 

A job step or procedure step can contain up to five DD statements with DDNAME 
parameters. Each DDNAME parameter must refer to a different DD statement. 



Overrides 



If any DCB subparameter appears on both DD statements, the DCB subparameter on the 
referenced DD statement overrides the DCB subparameter on the DD statement that contains 
DDNAME. 

Relationship to Other Parameters 

The only DD parameters you can code with the DDNAME parameter are: 

AMP 

DCB = BLKSIZE 

DCB=BUFNO 

DCB = DIAGNS 

Do not code the DDNAME parameter on a DD statement with a ddname of JOBLIB, 
JOBCAT, or STEPCAT. 

Location in the JCL 

Place a DD statement containing a DDNAME parameter in a job step or in a cataloged or 
in-stream procedure. The referenced DD statement must be later in the same job step, must be 
in the calling job step, or must be in a cataloged or in-stream procedure called by the job step. 

If the referenced data set is to be concatenated with other data sets, the DD statements for the 
concatenated data sets must immediately follow the DD statement that contains the DDNAME 
parameter. 
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Errors in Location of Referenced DD Statement: The system treats a DDNAME parameter as 
through it were a DUMMY parameter and issues a warning message in the following cases: 

• If the job step or called procedure does not contain the referenced DD statement. 

• If the referenced DD statement appears earlier in the job step. 



Location of DD Statement Requesting Unit Affinity: To use the same device, a DD statement 
can request unit affinity to an eariier DD statement by specifying UNIT = AFF = ddname. If a 
DD statement requests unit affinity to a DD statement containing a DDNAME parameter, the 
DD statement requesting unit affinity must be placed after the referenced DD statement. If the 
DD statement requesting unit affinity appears before, the system treats the DD statement 
requesting unit affinity as a DUMMY DD statement. 

//STEP EXEC PGM=TKM 

//DDl DD DDNAME=DD4 

//DD2 DD DSNAME=A,DISP=OLD 

//DD4 DD DSNAME=B,DISP=OLD 
//DD5 DD UNIT=AFF=DD1 

DDl postpones defining the data set until DD4. DD5 requests unit affinity to DDL Because 
DDl has been defined when DD5 is processed, the system assigns DD5 to the same device as 
DDl. 

Instead of specifying UNIT = AFF = ddname, both DD statements can specify the same devices 
in their UNIT parameters or the same volume serials in their VOLUME parameters. 



Referenced DD Statement 



If the DDNAME parameter appears in a procedure with multiple steps, the ddname on the 
referenced DD statement takes the form stepname.ddname. For example, if procedure step 
STEPCPl contains: 

//INDATA DD DDNAME=DD1 

The referenced DD statement in the calling job step is: 

//STEPCPl. DDl DD * 

Parameters not Permitted on the Referenced DD Statement: The referenced DD statement must 
not contain a DYNAM parameter. 

A DD statement that contains a DDNAME parameter must not override a procedure sysout 
DD statement that Qontains an OUTPUT parameter if the referenced DD statement also 
contains an OUTPUT parameter. 
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//DDl 


DD 


//DD2 


DD 


//DD3 


DD 


// 




//DD4 


DD 


//DD5 


DD 


//INPUT 


DD 


// 





Backward References 

A backward reference is a reference to an earlier DD statement in the job or in a cataloged or 
in-stream procedure called by a job step. A backward reference is in the form *.ddname or 
*.stepname.ddname or *.stepname.procstepname.ddname. The ddname in the reference is the 
ddname of the earlier DD statement. If the earlier DD statement contains a DDNAME 
parameter, the reference is to the ddname in the name field of the earlier statement, not to the 
ddname in the DDNAME parameter. 

The DD statement referenced in a DDNAME parameter cannot refer to a DD statement 
between the statement containing the DDNAME parameter and itself. For example: 

//SHOW EXEC PGM=ABLE 

DDNAME= INPUT 

DSNAME=TEMPSPAC , SPACE= ( TRK , 1) , UNIT=SYSDA 

DSNAME=INCOPY , VOLUME=REF=* . DDl , 

DISP=( ,KEEP) ,SPACE=(TRK, (5,2) ) 

DSNAME=OUTLIST , DISP=OLD 

DSNAME=MESSAGE,DISP=OLD,UNIT=3330,VOLUME=SER=3 3333 3 

DSNAME=NEWLIST,DISP= (OLD, KEEP) ,V0LUME=SER=3 33333 , 

UNIT=3330 

The DDNAME parameter on DDl refers to DD statement INPUT. The VOLUME parameter 
of DD3 specifies a backward reference to DDl, which is the name field ddname. 

DD statement INPUT identifies the volume 333333 in its VOLUME = SER = 333333 parameter. 
DD statement INPUT cannot use a backward reference to the VOLUME parameter on DD5 
because DD5 is between the referring DDl and the referenced INPUT. 

Examples of the DDNAME Parameter 



The following procedure step is the only step in a cataloged procedure named CROWE: 

PGM=RECPGM 
DDNAME =WKREC 
DSNAME=0LDREC , DISP=OLD 

DD statement DDl is intended for weekly records in the input stream; these records are 
processed by this step. Because the * and DATA parameters cannot be used in cataloged 
procedures, the DDNAME parameter is coded to postpone defining the data set until the 
procedure is called by a job step. The step that calls the procedure is: 

//STEPA EXEC PROC=CROWE 
//WKREC DD * 



data 



//PROCSTEP 


EXEC 


//DDl 


DD 


//POD 


DD 
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When the procedure contains multiple steps, use the form stepname.ddname for the ddname of 
the referenced DD statemento For example, the following procedure steps appear in a cataloged 
procedure named PRICE: 



//STEPl EXEC PGM=SUGAR 
//DDl DD DDNAME=QUOTES 



//STEP2 EXEC PGM=MOLASS 

//DD2 DD DSNAME=WEEKB,DISP=OLD 



The step that calls the procedure is: 

//STEPA EXEC PROC=PRICE 
//STEPl. QUOTES DD * 



data 



10-58 MVS/XA JCL Reference 



DD:DEST 



DEST Parameter 



Parameter Type: Keyword, optional 

Purpose: Use the DEST parameter to specify a destination for a sysout data set. The DEST 
parameter can send a sysout data set to a remote or local terminal, a node, a node and remote 
work station, a local device or group of devices, or a node and userid. 

Note: Code the DEST parameter only on a DD statement with a SYSOUT parameter. 
Otherwise, the system checks the DEST parameter for syntax, then ignores it. 

Syntax: 



DEST=destination 

The destination subparameter for JES2 is one of the following: 

LOCAL 

name 

Nnnnn 

NnnRmmmm 

NnnnRmram 

NnnnRmmm 

NnnnnRmm 

Rnnnn 

RMnnnn 

RMTnnnn 

Unnnn 

(node, userid) 

The destination subparameter for JES3 is one of the following: 

AisIYLOCAL 
device -name 
device-number 
group -name 
nodename 
(node, userid) 



Subparameter Definition for JES2 Systems 

LOCAL 

Indicates any local device. 

name 

Identifies a local or remote device by a symbolic name defined by the installation during 
JES2 initialization. The name is 1 through 8 alphanumeric or national characters. 

Nnnnn 

Identifies a node, nnnn is 1 through 4 decimal numbers from 1 through 1000. 
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NnnRmminin 
NnnnRmmm 
NnnnnRmm 

Identifies a node and a remote work station connected to the node. The node number, 
indicated in the format by n, is 1 through 4 decimal numbers from 1 through 1000. The 
remote work station number, indicated in the format by m, is I through 4 decimal 
numbers from 1 through 4000. Do not code leading zeros in n or m. The maximum 
number of digits for n and m combined cannot exceed six. 

Note: RO is equivalent to specifying LOCAL at node Nn. 

Rnnnn 

RMnnnn 

RMTnnnn 

Identifies a remote terminal, nnnn is 1 through 4 decimal numbers from 1 through 4000. 

Note: RO is equivalent to LOCAL. 

Unnnn 

Identifies a local terminal with special routing, nnnn is 1 through 4 decimal numbers 
from 1 through 4000. 

(iiode,userid) 

Identifies a node and a TSO or VM userid at that node. The node is a symbolic name 
defined by the installation during initialization; node is 1 through 8 alphanumeric or 
national characters The userid must be defined at the node; userid for TSO is 1 through 
7 alphanumeric or national characters and for VM is 1 through 8 alphanumeric or 
national characters. 

A userid requires a node; therefore, code DEST = (node,userid). You cannot code a 
userid without a node. 

DEST = (node) is valid with a writer-name subparameter in the SYSOUT parameter; 
however, DEST = (node,userid) is invalid. Therefore, you can code 
SYSOUT = (A,writer-name),DEST = (node). 

Subparameter Definition for JES3 Systems 

ANYLOCAL 

Indicates any local device that is attached to the global processor. 

device-name 

Identifies a local device by a symbolic name defined by the installation during JESS 
initialization, device-name is 1 through 8 alphanumeric or national characters. 

device-number 

Identifies the 3-character device number. 

group-name 

Identifies a group of local devices, an individual remote station, or a group of remote 
stations by a symbolic name defined by the installation during JES3 initialization, 
group-name is 1 through 8 alphanumeric or national characters. 
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nodename 

Identifies a node by a symbolic name defined by the installation during JES3 
initialization, nodename is 1 through 8 alphanumeric or national characters. If the 
nodename you specify is the same as the node you are working on, JES3 treats the output 
as though you specified ANYLOCAL. 

(node,userid) 

Identifies a node and a TSO or VM userid at that node. The node is a symbolic name 
defined by the installation during initialization; node is 1 through 8 alphanumeric or 
national characters. The userid must be defined at the node; userid for TSO is 1 through 
7 alphanumeric or national characters and for VM is 1 through 8 alphanumeric or 
national characters. 

A userid requires a node; therefore, code DEST = (node, userid). You cannot code a 
userid without a node. 

DEST = (node) is valid with a writer-name subparameter in the SYSOUT parameter: 
however, DEST = (node,userid) is invalid. Therefore, you can code 
SYSOUT = (A,writer-name),DEST = (node). 

Defaults 

If you do not code a DEST parameter, JES directs the sysout data set to the default destination 
for the input device from which the job was submitted. 

If a specified destination is invahd, the job fails. 

Overrides 

The DEST parameter on the sysout DD statement overrides an OUTPUT JCL DEST 
parameter. 

Relationship to Other Parameters 

Do not code the following parameters with the DEST parameter. 

* DLM 
DATA DYNAM 
DDNAME QNAME 

You must code a SYSOUT parameter on a DD statement with a DEST parameter. 
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Relationship to Other Control Statements 

You can also code an output destination using: 

• The OUTPUT JCL statement. 

• The JES2 /*OUTPUT and /*ROUTE control statements. 

• The JES3 //*MAIN, //*FORMAT PR, and //*FORMAT PU control statements. 

Because DEST = (node,userid) cannot be coded on JES2 or JESS control statements, you must 
code it, if needed, on a DD or OUTPUT JCL statement. 

Examples of the DEST Parameter 



//JOBOl JOB , 'MAE BIRD' ,MSGCLASS=B 

//STEPl EXEC PGM=INTEREST 

//DEBIT DD SYSOUT=A 

//CALIF DD SYSOUT=A,DEST=R555 

//FLOR DD SYSOUT=A, DEST= (BOCA, '9212028' ) 

In this example, the system sends the sysout data set defined by DD statement DEBIT to the 
work station that submitted the job, the data set defined by DD statement CALIF to the 
remote terminal 555, and the data set defined by DD statement FLOR to VM userid 9212U28 
at node BOCA. 
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DISP Parameter 



Parameter Type: Keyword, optional 

Purpose: Use the DISP parameter to describe the status of a data set to the system and tell the 
system what to do with the data set after termination of the step or job. You can specify one 
disposition for normal termination and another for abnormal termination. 

Note: Disposition of the data set is controlled solely by the DISP parameter; disposition of the 
voluine(s) on which the data set resides is a function of the volume status when the volume is 
demounted. 

References: For information about tape data set processing, see Magnetic Tape Labels and File 
Structure Administration. 



Syntax: 



DISP=status 

DISP=( [status] [ ,normal-termination-disp] [ ,abnorinal-termination-disp] ) 



DISP= 



"NEW 1 
OLD 
SHR 
MOD 



, DELETE 
,KEEP 
,PASS 
, CATLG 
, UNCATLG 



; DELETE 
.KEEP 
, CATLG 
, UNCATLG 



• You can omit the parentheses if you code only the status subparameter. 

• If you omit the status subparameter but code subparameters for normal or abnormal 
termination disposition, you must code a comma to indicate the absence of NEW. For 
example, DISP = (,KEEP) or DISP = (,CATLG,DELETE). 

• If you omit the second subparameter but code the third, you must code a comma to 
indicate the absence of the second subparameter. For example, 

DISP = (OLD„DELETE) or DISP = („KEEP). 



Subparameter DeHnition 



Status Subparameter 

NEW 



Indicates that a new data set is to be created in this step. 



OLD 



Indicates that the data set exists before this step and that this step requires exclusive 
(unshared) use of the data set. 
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If you specify DISP = OLD for an output tape data set and (1) the data set is not 
protected by RACF or a password or (2) the data set has no expiration date, the system 
does not verify the data set name in the header label. 

Srxlv 

Indicates that the data set exists before this step and that another job can share it, that is, 
use it at the same time. This subparameter can also be coded as SHARE. 

If you specify DISP = SHR for an output tape data set and (1) the data set is not 
protected by RACF or a password or (2) the data set has no expiration date, the system 
does not verify the data set name in the header label. 

MOD 

Indicates one of the following: 

• The data set exists. Records are to be added to the end of the data set. The data set 
must be sequential. 

• A new data set is to be created. 

In either case, MOD specifies exclusive (unshared) use of the data set. 

When the data set is opened, the read/write mechanism is positioned after the last 
sequential record for an existing data set or at the beginning for a new data set. For 
subsequent OPENs within the same step, the read/write mechanism is positioned after the 
last sequential record. 

Note: You cannot specify DISP = MOD to extend ISO/ANSI/FIPS Version 3 tape data 
sets, unless the ISO/ANSI/FIPS Version 3 label validation installation exit allows the 
extension. For information on using ISO/ANSI/FIPS Version 3 installation exits, see 
Magnetic Tape Labels and File Structure Administration. 

To use DISP = MOD to create a new data set, specify the following: 

• No VOLUME = SER or VOLUME = REF parameter on the DD statement. The 
data set must not be cataloged or passed from another job step. 

• A VOLUME = REF parameter that refers to a DD statement that makes a 
nonspecific volume request. One of the following must also be true: 

- The DSNAME parameters in the two DD statements must be different. 

- The two DD statements must request different areas of the same ISAM data set. 

A nonspecific volume request is a DD statement for a new data set that can be 
assigned to any volume or volumes. 

After the system chooses a volume for a new data set, if the system finds another data set 
with the same name on that volume, the system will try to allocate a different volume. 

In a JES3 system, if you code DISP = MOD for a multivolume data set and any of the 
volumes are JES3-managed, JES3 will not execute the job until all volumes, including 
scratch volumes being added, are allocated. Such a job will wait on the queue until all 
volumes are allocated. 
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Normal Termination Disposition Subparameter 

DELETE 

Indicates that the data set's space on the volume is to be released if this step terminates 
normally. The space can be used for other data sets; the data set in not erased from the 
space. 

The data set is deleted only if its retention period or expiration date has passed; 
otherwise the data set is kept. See the DD EXPDT or RETPD parameters. 

If the system retrieves volume information from the catalog because the DD statement 
does not specify VOLUME = SER or VOLUME = REF, then DELETE implies 
UNCATALOG: the system deletes the data set and removes its catalog entry, 

KEEP 

Indicates that the data set is to be kept on the volume if this step terminates normally. 

Only KEEP is valid for VSAM data sets. VSAM data sets should not be passed, 
cataloged, uncataloged, or deleted. 

PASS 

Indicates that the data set is to be passed for use by a subsequent step in the same job. 

Note: A data set can be passed only within a job. 

CATLG 

Indicates that, if the step terminates normally, the system is to place an entry pointing to 
the data set in the system or user catalog. For CVOL catalogs, the system creates any 
missing index levels. Note that the data set is kept. 

An unopened tape data set is cataloged, unless the volume request is nonspecific or unless 
the data set is allocated to a dual-density tape drive but no density is specified. A 
nonspecific volume request is a DD statement for a new data set that can be assigned to 
any volume or volumes. 

For information about the rules for cataloged data set names, refer to Integrated Catalog 
Administration: Access Method Services Reference or VSAM Catalog Administration: 
Access Method Services Reference. 

UNCATLG 

Indicates that, if the step terminates normally, the system is to delete (1) the entry 
pointing to the data set in the system or user catalog and (2) unneeded indexes, except for 
the highest level entry. Note that the data set is kept. 

Abnormal Termination (Conditional) Disposition Subparameter 

DELETE 

Indicates that the data set's space on the volume is to be released if this step terminates 
abnormally. The space can be used for other data sets; the data set in not erased from 
the space. 

The data set is deleted only if its retention period or expiration date has passed; 
otherwise the data set is kept. See the DD EXPDT or RETPD parameters. If the data 
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Defaults 



set was being created when the step abnormally terminates, the data set is deleted even 
though it has an unexpired retention period or expiration date. 

If the system retrieves volume information from the catalog because the DD statement 
does not specify VOLUME = SER or VOLUME = REF, then DELETE implies 
UNCATALOG: the system deletes the data set and removes its catalog entry. 

For a cataloged, passed data set, the user catalog is not updated. 

KEEP 

Indicates that the data set is to be kept on the volume if this step terminates abnormally. 

Only KEEP is valid for VSAM data sets. VSAM data sets should not be passed, 
cataloged, uncataloged, or deleted. 

CATLG 

Indicates that, if the step terminates abnormally, the system is to place an entry pointing 
to the data set in the system or user catalog. For CVOL catalogs, the system creates any 
missing index levels. Note that the data set is kept. 

An unopened tape data set is cataloged, unless the volume request is nonspecific or unless 
the data set is allocated to a dual-density tape drive but no density is specified. 

For a cataloged, passed data set, the user catalog is not updated. A passed, not received 
data set is not cataloged if the data set name has a first-level qualifier of a catalog name 
or ahas. 

UNCATLG 

Indicates that,if this step terminates abnormally, the system is to delete (1) the entry 
pointing to the data set in the system or user catalog and (2) unneeded indexes, except for 
the highest level entry. Note that the data set is kept. 

For a cataloged, passed data set, the user catalog is not updated. 



If you omit the status subparameter, the default is NEW. 

If you omit the normal termination disposition subparameter, the default is DELETE for a 
NEW data set or KEEP for an existing data set. 

If you omit the abnormal termination disposition subparameter, the default is the 
disposition specified or implied by the second subparameter. However, if the second 
subparameter specified PASS, the default abnormal termination disposition is DELETE for 
a NEW data set or KEEP for an existing data set. 

If you omit the DISP parameter, the default is a NEW data set with a disposition of 
DELETE for both normal and abnormal termination disposition. Thus, you can omit the 
DISP parameter for a data set that is created and deleted during a step. 
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Relationship to Other Parameters 

Do not code the following parameters with the DISP parameter. 



« 


DATA 


MODIFY 


BURST 


DDNAME 


OUTLIM 


CHARS 


DLM 


OUTPUT 


CHKPT 


DYNAM 


QNAME 


COPIES 


FLASH 


SYSOUT 



Disposition of QSAM Data Sets 



Do not code DISP = MOD if the data control block (DCB) specifies RECFM = FBS and the 
data set is processed by QSAM. If you do and a block is shorter than the specified block size, 
QSAM assumes that the short block is the last block and starts end-of-file processing. By this 
action, QSAM can embed short blocks in your data set and so affect the number of records per 
track. 

Disposition of VSAM Data Sets 

Only KEEP is vaHd for VSAM data sets. VSAM data sets should not be passed, cataloged, 
uncataloged, or deleted. 

Disposition of Temporary Data Sets 

Specify a normal termination disposition of PASS or DELETE for a temporary data set or for 
a data set with a system -generated name, that is, when a DSNAME parameter is omitted from 
the DD statement. 

For a temporary data set name, the system ignores any abnormal termination disposition 
specified in the third subparameter. 

Disposition of Partitioned Data Sets 

When you specify DISP = MOD or DISP = NEW for a partitioned data set and you also specify 
a member name in the DSNAME parameter, the member name must not already exist. If the 
member name already exists, the system terminates the job. 

When you specify DISP = OLD for a partitioned data set and you also specify a member name 
in the DSNAME parameter, the data set must already exist. If the member name already exists 
and the data set is opened for output, the system replaces the existing member with the new 
member. If the member name does not already exist and the data set is opened for output, the 
system adds the member to the data set. 

When you specify DISP = MOD for a partitioned data set and you do not specify a member 
name, the system positions the read/write mechanism at the end of the data set. The system 
does not make an automatic entry into the directory. 

When you specify DISP = MOD for a partitioned data set and you do specify a member name, 
the system positions the read/write mechanism at the end of the data set. If the member name 
already exists, the system terminates the job. 
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DISP = MOD for a Multivolume Data Set 

When you code DISP = MOD and the volume information is for a multivolume data set, 
normally the first volume(s) will be mounted on the devices(s) allocated. Then, if the data set is 
opened for output, OPEN starts with the last volume. If the number of volumes is more than 
the number of allocated devices, the system asks the operator to demount the first volume(s) 
and mount the last. To have the last volume mounted without first mounting and then 
demounting the first volume(s): 

• For DASD, code DEFER in the UNIT parameter or a volume sequence number in the 
VOLUME parameter. If you code VOLUME = REF, you must also code either DEFER in 
the UNIT parameter or a volume sequence number in the VOLUME parameter. 

• For tape, code VOLUME = REF or DEFER in the UNIT parameter or a volume sequence 
number in the VOLUME parameter. 

When you code DISP = MOD for a multivolume tape data set, use the volume count and 
volume sequence number subparameters of the VOLUME parameter to keep the system from 
positioning the read/write mechanism after the last record on the last volume. For example: 

//DDEXl DD DSNAME=OPER. DATA, DISP={ MOD, KEEP ) ,VOLUME=( ,, ,1,2) 

The volume sequence number of 1 specifies that you want to use the first volume, and the 
volume count of 2 specifies that the data set requires two volumes. 

If you want to extend a cataloged, multivolume data set and have it properly cataloged after it 
is kept or passed, code the VOLUME and UNIT parameters to make the system use the values 
in the system catalog to process the data set. The following DD statement shows how to keep 
and extend a cataloged multivolume data set using the system catalog. Remember that this 
data set was created with a volume count of 2. 

//DDEX2 DD DSNAME=OPER. DATA, DISP=( MOD, KEEP ) , 
// VOLUME=(, ,, ,3) ,UNIT={,P) 

The VOLUME parameter references the system catalog for volume information about the data 
set and increases the maximum number of volumes for OPER.DATA. Because the UNIT 
parameter requests parallel mounting, the system must allocate the same number of units as the 
number of volumes in the VOLUME parameter; in this case, 3. 

The following is an example of the messages in the job log after the job completes. 

IEF285I OPER.DATA KEPT 

IEF285I VOL SER NOS= 333001,333002,333003. 

IEF285I OPER.DATA RECATALOGED 

IEF285I VOL SER NOS= 333001,333002,333003. 

If you do not reference the system catalog when extending cataloged multivolume data sets, the 
system does not update the system catalog with the newly referenced volumes. 
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Effect of DCB =dsnaine Parameter 



If the DCB parameter refers to a cataloged data set, the system obtains the vohmie sequence 
number from the label of the data set, unless the volume sequence number is coded on the DD 
statement. 

Thus, for the following DD statement, even though DISP = MOD is specified, the system 
positions the read/write mechanism after the last record on the volume specified in the volume 
sequence number in the label; this volume may or may not be the last volume. 

//DDl DD DSNAME=MULTI1,DISP=M0D,DCB=CATDD 

To control which volume is processed, code a volume sequence number. 

//DD2 DD DSNAME=MULTI2,DISP=M0D,DCB=CATDD,V0LUME=( , , ,2) 
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Summary of Disposition Processing 



DISP Subparameters: | 


Disposition (If Data Set was Allocated): | 
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Figure 10-1 (Part 1 of 2). Summary of Disposition Processing 
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DISP Subparameters: 


Disposition (If Data Set was Allocated): | 
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Figure 10-1 (Part 2 of 2). Summary of Disposition Processing 
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Examples of the DISP Parameter 



//DD2 DD DSNAME=FIX,UNIT=3420-1,VOLUME=SER=44889, 
// DISP=(OLD, , DELETE) 

DD statement DD2 defines an existing data set and implies by the omitted second 
subparameter that the data set is to be kept if the step terminates normally. The statement 
requests that the system delete the data set if the step terminates abnormally. 

//STEPA EXEC PGM=FILL 

//DDl DD DSNAME=SWITCH.LEVEL18.GROUP12,UNIT=3350, 

// V0LUME=SER=L0CAT3,SPACE=(TRK, (80,15) ) ,DISP=( ,PASS) 

//STEPB EXEC PGM=CHAR 

//DD2 DD DSNAME=XTRA,DISP=OLD 

//DD3 DD DSNAME=*. STEPA. DDl, DISP=( OLD, PASS, DELETE) 

//STEPC EXEC PGM=TERM 

//DD4 DD DSNAME=*. STEPB. DD3,DISP=( OLD, CATLG, DELETE) 

DD statement DDl defines a new data set and requests that the data set be passed. If STEPA 
abnormally terminates, the data set is deleted because it is a new data set, the second 
subparameter is PASS, and an abnormal termination disposition is not coded. 

DD statement DD3 in STEPB receives this passed data set and requests that the data set be 
passed. If STEPB abnormally terminates, the data set is deleted because of the third 
subparameter of DELETE. 

DD statement DD4 in STEPC receives the passed data set and requests that the data set be 
cataloged at the end of the step. If STEPC abnormally terminates, the data set is deleted 
because of the abnormal termination disposition of DELETE. 

DD statement DD2 defines an old data set named XTRA. When STEPB terminates, normally 
or abnormally, this data set is kept. 
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DLM Parameter 



Parameter Type: Keyword, optional 

Purpose: Use the DLM parameter to specify a delimiter to terminate this in-stream data set. 
When the DLM parameter assigns a different delimiter, the in-stream data records can include 
standard delimiters, such as /* and //, in the data. 

In a JES2 system, when the DLM delimiter appears on a DD * statement, either the assigned 
delimiter or // ends the input data set. When the DLM delimiter appears on a DD DATA 
statement, only the assigned dehmiter ends the input data set. 

In a JES3 system, when the DLM delimiter appears on either a DD * or DD DATA statement, 
only the assigned delimiter ends the input data set. 

Note: When the DLM delimiter overrides any implied delimiter, you must terminate the data 
with the DLM characters. Otherwise, the system keeps reading until the reader is empty. 

Except for the JES2 /*SIGNON and /*SIGNOFF statements, the system does not recognize 
JES2 and JES3 statements in an input stream between the DLM parameter and the delimiter it 
assigns. The JES2 /*SIGNON and /*SIGNOFF statements are processed by the remote work 
station regardless of any DLM delimiter. 

Syntax: 



DLM=delimiter 



• If the specified delimiter contains any special characters, enclose it in apostrophes. In 
this case, a special character is any character that is neither alphanumeric nor national. 

Faihng to code enclosing apostrophes produces unpredictable results. 

• If the delimiter contains an ampersand or an apostrophe, code each ampersand or 
apostrophe as two consecutive ampersands or apostrophes. Each pair of consecutive 
ampersands or apostrophes counts as one character. 



Subparameter Definition 

delimiter 

Specifies two characters that indicate the ena ot tins data set in the input stream. 

Default 

If you do not specify a DLM parameter, the default is the /* delimiter statement. 

If the system finds an error on the DD statement before the DLM parameter, it does not 
recognize the value assigned as a delimiter. The system reads records until it reads a record 
beginning with /* or //. 
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Relationship to Otlier Parameters 

The only DD parameters you can code with the DLM parameter are: 

* 

DATA 
DCB 
DSID 
VOLUME 

The DLM parameter has meaning only on statements defining data in the input stream, that is, 
DD * and DD DATA statements. If DLM is specified on any other statement, a JCL error 
message is issued. 

Invalid Delimiters 

If the delimiter is not two characters: 

• For JES2, if only one character is specified, JES2 uses the installation-defined default. If 
more than two characters are specified, JES2 terminates the job. 

• For JES3, if an incorrect number of characters is coded, JES3 terminates the job. 
Example of the DLM Parameter 

//DDl DD *,DLM=AA 

data 
AA 

The DLM parameter assigns the characters AA as the delimiter for the data defined in the 
input stream by DD statement DDl. For JES2, the characters // would also serve as valid 
deUmiters since a DD * statement was used. JES3 accepts only the characters specified for the 
DLM parameter as a terminator for DD * or DD DATA. 
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DSID Parameter 



Parameter Type: Keyword, optional 

Purpose: Use the DSID parameter to specify the data set identifier of an input or output data 
set on a diskette of the 3540 Diskette Input/Output Unit. 

An input data set is read from a 3540 diskette by a diskette reader program, and an output data 
set is written on a 3540 diskette by a diskette writer, which is an external writer. Neither JES2 
nor JES3 can read or write diskette data sets. 

To read a data set from a 3540 diskette, the DD statement must contain: 

• A DSID parameter. 

• An * or DATA parameter, to begin the input stream data set. 

To write a data set on a 3540 diskette, the DD statement must contain: 

• A DSID parameter. 

• A SYSOUT parameter that specifies the output class that the diskette writer processes and 
the name of the diskette writer. 

Also, a system command, from the operator or in the input stream, must start the diskette 
writer before this DD statement is processed. 

Note: The DSID parameter is ignored on a DD *, DD DATA, or sysout DD statement that is 
processed by JES2 or JES3. 

References: For more information about associated data sets, see IBM 3540 Programmer's 
Reference. External writers are described in SPL: System Modifications. 



Syntax: 






DSID= 


id 
{id,[V]) 




You can omit the parentheses if you code only an id. 



Subparameter Definition 
id 



Specifies the data set identifier. The id is 1 through 8 characters. The characters must be 
alphanumeric, national, a hyphen, or a left bracket. The first character must be 
alphabetic or national. 

V 

Indicates that the data set label must have been previously verified on a 3741 Data 
Station/Workstation. This subparameter is required only on a SYSIN DD statement. 
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Relationship to Other Parameters 

Do not code the following parameters with the DSID parameter. 

BURST FLASH 

CHARS MODIFY 

DDNAME MSVGP 

DYNAM QNAME 

For 3540 Diskette InputjOutput Units: A DSID parameter on a DD *, DD DATA, or sysout 
DD statement is ignored except when detected by a diskette reader as a request for an 
associated data set. See IBM 3540 Programmer's Reference. 

On a DD * or DD DATA statement processed by a diskette reader, you can specify DSID, 
VOLUME = SER, DCB = BUFNO, and DCB = LRECL to indicate that a diskette data set is to 
be merged into the input stream following the DD statement. 

Example of the DSID Parameter 



// JOBl JOB , , MSGLEVEL= (1,1) 

//STEP EXEC PGM=AION 

//SYSIN DD *,DSID=(ABLE,V) ,VOLUME=SER=123456, 

// DCB=LRECL=80 

//SYSPRINT DD SYSOUT=E ,DCB=LRECL=128 , DSID=BAKER 

In this example, the SYSIN DD statement indicates that the input is on diskette 123456 in data 
set ABLE and must have been verified. The output will be written on a diskette in data set 
BAKER. 
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DSNAME Parameter 



Parameter Type: Keyword, optional 

Purpose: Use the DSNAME parameter to specify the name of a data set. For a new data set, 
the specified name is assigned to the data set; for an existing data set, the system uses the name 
to locate the data set. 



References: Partitioned data sets are described in Data Administration Guide. 
Syntax: 



DSNAME 
[DSN 



=name 



name for permanent data set: 

dsname 

dsname ( member ) 
dsname ( generation ) 
dsname (area) 

name for temporary data set: 

&&dsname 
s&dsname (member) 
&&dsname(area) 

name copied from earlier DD statement: 

* . ddname 

* . stepname . ddname 

* .stepname.procstepname. ddname 

name for dummy data set: 

NULLFILE 



• You can abbreviate DSNAME as DSN. 

• If the data set name begins with a blank character, the system assigns the data set a 
temporary data set name. 

• The system ignores blank characters at the end of a data set natne. 

Special Characters: When a data set name contains special characters that are not significant 
to the system, other than hyphens, enclose it in apostrophes. For example, 
DSNAME = 'DS/29'. 

Code each apostrophe that is part of the data set name as two consecutive apostrophes. For 
example, code DAYS'END as DSNAME = 'DAYS"END'. 
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The following special characters are significant to the system. Do not enclose them in 
apostrophes. 

• Periods to indicate a qualified data set name. However, you must enclose in apostrophes 
a period immediately before a right parenthesis, immediately after a left parenthesis, or 
immediately before a comma; for example, DSNAME = '(-ABC)' and 

DSNAME - (ABC.y and DSNAME = 'A.B.C.', 

• Double ampersands to identify a temporary data set name. 

• Parentheses to enclose the member name of a partitioned data set, the area name of an 
indexed sequential data set, or the generation number of a generation data set. 

• Plus ( + ) or minus (-) sign to identify a generation of a generation data group. 

• The asterisk to indicate a backward reference. 

On a DD statement in a cataloged or in-stream procedure, if the data set name is a symbolic 
parameter, do not enclose it in apostrophes. If it is enclosed in apostrophes, the system 
performs correct substitution only if the symbolic parameter enclosed in apostrophes is 
preceded by a symbolic parameter not enclosed in apostrophes. 

The data set name should not contain the 44 special characters (X'04') created by the 12-4-9 
multiple punch or any operation that converts the value of characters to X'04'. 



Subparameter Definition 

Data Set Name for Permanent Data Set 

Assign a permanent data set either an unqualified or qualified name: 

Unqualifiedl Name: 1 through 8 alphanumeric or national characters, a hyphen, or a 
character X'CO'. The first character must be alphabetic or national. Do not use hyphens 
in data set names for RACF-protected data sets. Do not use national characters in 
ISO/ANSI/FIPS version 3 tape data set names. 

Qualified Name: multiple names joined by periods. Each name is coded like an unqualified 
name; therefore, the name must contain a period every 8 characters or less. The maximum 
length of a qualified data set name is: 

• 44 characters, including periods. 

• For a generation data group, 35 characters, including periods. 

• For an output tape data set, 17 characters, including periods. If longer than 17 
characters, caly the rightmost 17 characters are written to the tape header label. For 
more information, see Magnetic Tape Labels and File Structure Administration. 

Name for RACF-Protected Data Set: The Resource Access Control Facility (RACE) 
expects the data set name to have a high-level qualifier that is defined to RACE. See the 
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RACF Security Administrator's Guide for details. RACF Version 1 Release 7 uses the entire 
data set name, from 1 through 44 characters, when protecting a tape data set. 

dsname 

Specifies a data set name. 

dsname(iiieinber) 

Specifies a permanent partitioned data set name and the name of a member within that 
data set. 

dsnaine(generatioii) 

Specifies the name of a generation data group (GDG) and the generation number (zero or 
a signed integer) of a generation data set within the GDG. 

To retrieve all generations of a generation data group, omit the generation number. 

dsname(area) 

Specifies the name of a permanent indexed sequential data set and an area of the data set. 
The area-name is INDEX, PRIME, or OVFLOW. 

If you define an indexed sequential data set on only one DD statement, omit the area 
name or code it as PRIME. For example, DSNAME = dsname or 
DSNAME = dsname(PRIME). 

To retrieve an indexed sequential data set, omit the area name. 

Data Set Name for Temporary Data Set 

A temporary data set is created and deleted within a job. When defining a temporary data set, 
you can code the DSNAME parameter or omit it; if omitted, the system will generate a name 
for the data set. 

When coded, the data set name for a temporary data set consists two ampersands (&&) 
followed by 1 through 8 alphanumeric or national characters, a hyphen, or a character X'CO'. 
The first character following the ampersands must be alphabetic or national. 

The system generates a qualified name for the temporary data set. The name begins with SYS 
and includes the job name, the data set name from the DSNAME parameter, if coded, and 
other identifying characters. If several jobs enter the system at the same time and contain DD 
statements with the same temporary data set name or with no data set name, the qualified 
names generated by the system will not be unique. 

Note: A single ampersand before a data set name in a cataloged or in-stream procedure 
signifies a symbolic parameter. However, if no value is assigned to the name on either the 
EXEC statement that calls the procedure or on a PROC statement in the procedure, the system 
treats the name as a temporary data set name. 
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&&dsnaine 

Specifies the name of a temporary data set. 

&&dsname(ineniber) 

Specifies the name of a temporary partitioned data set and a member within that data set. 

&&dsname(area) 

Specifies the name of a temporary indexed sequential data set and an area of the data set. 
The area name is INDEX, PRIME, or OVFLOW. 

If you define an indexed sequential data set on only one DD statement, omit the area 
name or code it as PRIME. For example, DSNAME = &&dsname or 
DSNAME = &&dsname(PRIME). 

Data Set Name Copied from Earlier DD Statement 

A backward reference is a reference to an earlier statement in the job or in a cataloged or 
in-stream procedure called by this or an earlier job step. A backward reference can be coded in 
the DSNAME parameter to copy a data set name from an earlier DD statement. 

When copying the data set name, the system also copies the following from the DD statement: 

• Whether or not the data set is a PDS. 

• Whether or not the data set is a temporary data set. 

*.ddname 

Asks the system to copy the data set name from earlier DD statement ddname. 

*.stepname.ddname 

Asks the system to copy the data set name from DD statement, ddname, in an earlier 
step, stepname, in the same job. 

*.stepname.procstepname.ddname 

Asks the system to copy the data set name from a DD statement in a cataloged or 
in-stream procedure. Stepname is the name of this job step or an earlier job step that 
calls the procedure, procstepname is the name of the procedure step that contains the DD 
statement, and ddname is the name of the DD statement. 

Data Set Name for Dummy Data Set 

NULLFILE 

Specifies a dummy data set. NULLFILE has the same effect as coding the DD 
DUMMY parameter. 

Relationship to Other Parameters 

Do not code the following parameters with the DSNAME parameter. 



* 


DATA 


FLASH 


QNAME 


BURST 


DDNAME 


MODIFY 


SYSOUT 


CHARS 


DLM 


OUTLIM 




COPIES 


DYNAM 


OUTPUT 
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With DD AMP Parameter: When you code an AMP parameter for a VSAM data set, do not 
code a DSNAME: 

# That contains parentheses, a minus (hyphen), or a plus ( + ) sign. 

# That is in the form for ISAM. 

• That is in the form for PAM (partitioned access method). 

• That names a generation data group. 



Examples of the DSNAME Parameter 



//DDl DD DSNAME=ALPHA,DISP=( ,KEEP) , 
// UNIT=3420,VOLUME=SER=389984 

DD statement DDl defines a new data set and names it ALPHA. DD statements in later job 
steps or jobs may retrieve this data set by specifying ALPHA in the DSNAME parameter, unit 
information in the UNIT parameter, and volume information in the VOLUME parameter. 

//DD2 DD DSNAME=LIB1(PR0G12) ,DISP=( OLD, KEEP) ,UNIT=3350 
// VOLUME=SER=882234 

DD statement DD2 retrieves member PROG 12 from the partitioned data set named LIBl. 

//DD3 DD DSNAME=&&WORK,UNIT=3420 

DD statement DD3 defines a temporary data set. Because the data set is deleted at the end of 
the job step, the DSNAME parameter can be omitted. The following example shows why a 
temporary data set should be named. 

//STEPl EXEC PGM=CREATE 

//DD4 DD DSNAME=&&ISDATA(PRIME) ,DISP=( ,PASS) ,UNIT=(3350,2) , 

// VOLUME=SER=334859,SPACE=(CYL, (10, ,2) , ,CONTIG) ,DCB=DSORG=IS 

//STEP2 EXEC PGM=OPER 

//DD5 DD DSNAME=*. STEP l.DD4,DISP=( OLD, DELETE) 

DD statement DD4 in STEPl defines a temporary indexed sequential data set named ISDATA. 
This DD statement defines all of the areas of an indexed sequential data set. DD statement 
DD5 in STEP2 retrieves the data set by referring to the earlier DD statement that defines the 
data set. Because the temporary data set is passed when it is defined in STEPl, it is not deleted 
at the end of STEPl and STEP2 can retrieve it. 
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DUMMY Parameter 



Parameter Type: Positional, optional 

Purpose: Use the DUMMY parameter to specify that: 

• No device or external storage space is to be allocated to the data set. 

• No disposition processing is to be performed on the data set. 

• For BSAM and QSAM, no input or output operations are to be performed on the data set. 

One use of the DUMMY parameter is in testing a program. When testing is finished and you 
want input or output operations performed on the data set, replace the DD DUMMY 
statement with a DD statement that fully defines the data set. 

Another use of the DUMMY parameter is in a cataloged or in-stream procedure. Code on the 
DD DUMMY statement all the required parameters. When the procedure is called, nullify the 
effects of the DUMMY parameter by coding on the DD statement that overrides the DD 
DUMMY statement a DSNAME parameter that matches the DSNAME parameter on the DD 
DUMMY statement. For example, procedure step PS contains the following: 

//DSl DD DUMMY, DSNAME=A,DISP=OLD 

Nullify the DUMMY parameter by coding: 

//JS EXEC PR0C=PR0C1 

//PS. DSl DD DSNAME=A 

Syntax: 



//ddname DD DUMMY [ ^parameter] . 



All parameters coded on a DD DUMMY statement must be syntactically correct. The 
system checks their syntax. 



Parameters on DD DUMMY Statements 

• Code the DUMMY parameter by itself or follow it with all the parameters you would 
normally code when defining a data set, except the DDNAME parameter. 

• Code the DCB parameter, if needed. If the program does not supply all the data control 
block information, make sure that the DCB parameter supplies the missing information. 

• Code AMP = AMORG if you are using VSAM. 

• If you code either VOLUME = REF = dsname or DCB == dsname with DUMMY, the 
referenced dsname must be cataloged or passed; otherwise, the job is terminated. 

• Because no I/O is performed to the dummy data set, the system checks the UNIT, SPACE, 
and DISP parameters, if coded, for syntax, then ignores them. 
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Relationship to Other Parameters 

Do not code the following parameters with the DUMMY parameter. 



* 


DLM 


DATA 


DYNAM 


DDNAME 


QNAME 



Relationship to Other Control Statements 

Backward References: If a later DD statement in a job refers to a DD DUMMY statement 

when requesting unit affinity (UNIT = AFF = ddname) or volume affinity 

(VOLUME = REF = *.stepname.ddname), the system assigns a dummy status to the later DD 

statement. 

Overriding a Procedure DD Statement: Coding DUMMY on a DD statement that overrides a 
DD statement in a procedure does not nullify symbolic parameters on the overridden DD 
statement. You must assign values to, or nuUify, symbohc parameters on the overridden DD 
statement as described in "Symbolic Parameters" on page 5-8. 

The DSNAME parameter on the overriding DD statement must not specify NULLFILE. 

If the overriding DD statement contains a SUBSYS parameter, the system nuUifies a DUMMY 
parameter on the overridden DD statement in the procedure. 

Data Sets Concatenated to Dummy Data Sets: The system treats data sets concatenated to a 
DUMMY data set as dummy data sets in that I/O operations are bypassed. However, the 
system performs disposition processing and allocates devices and storage for any concatenated 
data sets. 

Relationship to Access Methods 

Use one of the following access methods with the DUMMY parameter: 

• Basic sequential access method (BSAM) 

• Virtual storage access method (VSAM) 

• Queued sequential access method (QSAM) 

• BDAM load mode (BSAM with MACRF = WL in the data control block) 

If you use any other access method, the job is terminated. 
Examples of the DUMMY Parameter 



//OUTDDl DD DUMMY, DSNAME=X.X.Z,UNIT=3 350, 
// SPACE=(TRK, (10,2) ) ,DISP= ( ,CATLG) 

DD statement OUTDDl defines a dummy data set. The other parameters coded on the 
statement are checked for syntax but not used. 
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//INI DD DUMMY, DCB=(BLKSIZE=800,LRECL=400,RECFM=FB) 

DD statement INI defines a dummy data set. The DCB parameter supplies data control block 
information not supplied in the program. Without it, the step might be abnormally terminated. 

//IN2 DD DUMMY, DSNAME=ELLN,DISP=OLD,VOLUME=SER=11257,UNIT=3350 

When calling a cataloged procedure that contains DD statement IN2 in procedure step STEP4, 
you can nullify the effects of the DUMMY parameter by coding: 

//STEP4 . IN2 DD DSNAME=ELLN 



//TAB DD DSNAME=APP.LEV12,DISP=0LD 

If you call a cataloged procedure that contains DD statement TAB in procedure step STEPl, 
you can make this DD statement define a dummy data set by coding: 

//STEPl. TAB DD DUMMY 



//MSGS DD SYSOUT=A 

If you call a cataloged procedure that contains the DD statement MSGS in procedure step 
LOCK, you can make this DD statement define a dummy data set by coding: 

//LOCK. MSGS DD DUMMY 
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DYNAM Parameter 



Parameter Type: Positional, optional 

Purpose: Use the DYNAM parameter to increase by one the control value for dynamically 
allocated resources held for reuse. Even when DYNAM is not coded, the system normally 
holds resources in anticipation of reuse. The DYNAM parameter is supported to provide 
compatibility with older systems. 

A DD DYNAM statement is a dummy request. 

Syntax: 



//ddname DD DYNAM [comments] 



Relationship to Other Parameters 

Do not code any parameters with the DYNAM parameter. 

Do not code on a DD DYNAM statement a ddname that is meaningful to the system; for 
example, JOBLIB, SYSCHK. 

Relationship to Other Control Statements 

• Do not refer to a DD DYNAM statement in a DDNAME parameter. 

• To nullify the DYNAM parameter on a DD statement in a cataloged or in-stream 
procedure, code a SYSOUT or DSNAME parameter in the overriding DD statement. 
DSNAME = NULLFILE does not nullify a DYNAM parameter. 

• Do not code a backward reference to a DD DYNAM statement. 

• Do not code the DYNAM parameter on the first DD statement for a concatenation. 

Example of the DYNAM Parameter 



//INPUT DD DYNAM 

This DD statement increases by one the control value for dynamically allocated resources held 
for reuse. 
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FCB Parameter 



Parameter Type: Keyword, optional 
Purpose: Use the FCB parameter to specify: 

• The forms control buffer (FCB) image JES is to use to guide printing of this sysout data set 
by a 3211 Printer, 3203 Printer Model 5, 3800 Printing Subsystem, or 4248 Printer, or by a 
printer supported by systems network architecture (SNA) remote job entry (RJE). 

• The carriage control tape JES is to use to control printing of this sysout data set by a 1403 
Printer or by a printer supported by SNA RJE. 

• The data-protection image JES is to use to control output of this sysout data set by a 3525 
Card Punch. 



The FCB image specifies how many lines are to be printed per inch and the length of the form. 
JES loads the image into the printer's forms control buffer. The FCB image is stored in 
SYSl.IMAGELIB. IBM provides three standard FCB images: 

• STDl, which specifies 6 fines per inch on an 8.5-inch-long form. 

• STD2, which specifies 6 lines per inch on an 1 1 -inch-long form. 

• STD3, which in a JES3 system specifies 8 fines per inch for a dump. 

References: For more information on the forms control buffer, see System-Data 
Administration, Programming Support for the IBM 3505 Card Reader and IBM 3525 Card 
Punch, or 3800 Printing Subsystem Programmer's Guide. 

Syntax: 



FCB= 



f cb-name 

(fcb-name[ ,ALIGN| , VERIFY] 



• You can omit the parentheses if you code only the fcb-name. 

• Code the fcb-name as STDl or STD2 only to request the IBM-supplied images. 

• Code the fcb-name as STD3 only for a high-density dump in a JES3 system. 



Subparameter Definition 



fcb-name 

Identifies the FCB image. The name is 1 through 4 alphanumeric or national characters 
and is the last characters of a SYSl.IMAGELIB member name: 

• FCB2xxxx member for a 3211, a 3203 model 5, or a printer supported by SNA. 

• FCB3xxxx member for a 3800. 

• FCB4xxxx member for a 4248. 
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Overrides 



DD: FCB 

ALIGN 

Requests that the system ask the operator to check the alignment of the printer forms 
before the data set is printed. 

Note: 

• ALIGN is ignored for a sysout data set. 

• ALIGN is ignored for a data set printed on a 3800. The 3800 does not use the 
ALIGN subparameter. 

VERIFY 

Requests that the system ask the operator to verify that the image displayed on the 
printer is for the desired FCB image. The operator can also take this opportunity to align 
the printer forms. 

Note: VERIFY is ignored for a sysout data set. 



If you do not code the FCB parameter, the system checks the FCB image in the printer's forms 
control buffer; if it is a default image, as indicated by its first byte, JES uses it. If it is not a 
default image, JES loads the FCB image that is the installation default specified at JES 
initiaUzation. 



An FCB parameter on a sysout DD statement overrides an OUTPUT JCL FCB parameter. 



Relationship to Other Parameters 



Do not code the following parameters with the FCB parameter. 



* DLM 

AMP DYNAM 

DATA PROTECT 

DDNAME QNAME 



Do not code the following DCB subparameters with the FCB parameter. 



CYLOFL INTVL 

RKP 



For output to the 3525, do not code the SYSOUT parameter and the FCB parameter; the 
system ignores the FCB parameter. 
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Relationship to Other Control Statements 

You can also code the FCB parameter on the following: 

• The OUTPUT JCL statement 

• The JES2 /*OUTPUT statement. 

• The JES3 //*FORMAT PR statement. 

Defining an FCB Image for a Work Station 

When a work station uses a peripheral data set information record (PDIR), the FCB image is 
defined in the work station. The DD statement FCB fcb-name subparameter must match the 
FCB name defined in the PDIR work station. 

When a work station does not use a PDIR, add an FCB member to SYSl.IMAGELIB. At 

setup time, JES3 translates the FCB into a set vertical format (SVF). 

Requesting a High-Density Dump 

You can request a high-density dump on the 3800 through two parameters on the DD 
statement for the dump data set or on an OUTPUT JCL statement referenced by the dump DD 
statement: 

• FCB = STD3. This parameter produces dump output at 8 lines per inch. 

• CHARS = DUMP. This parameter produces 204-character print hnes. 

You can code one or both of these parameters. You can place both on the same statement or 
one on each statement. 

Examples of the FCB Parameter 

//DDl DD UNIT=32 11, FCB=(IMG1, VERIFY) 

In this example, the DD statement defines an output data set to be printed by a 3211. The 
FCB parameter requests that the data set be printed under control of the FCB2IMG1 member 
in SYSl.IMAGELIB. Because VERIFY is coded, the system displays the FCB image on the 
printer before printing the data set. 

//DD2 DD SYS0UT=A,FCB=IMG2 

This sysout DD statement specifies output class A. If output class A routes output to a printer 
having the forms control buffer feature, JES loads the FCB image IMG2 into the forms control 
buffer. If the printer does not have the forms control buffer feature, the operator receives a 
message to mount the carriage control tape IMG2 on the printer. 
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//OUTDDS DD UNIT=3211,FCB=(6,ALIGN) 

In this example, the DD statement defines an output data set to be printed by a 3211. The 
FCB parameter requests that the data set be printed under control of the FCB image named 6. 
Because ALIGN is coded, the system issues a message to the operator requesting that the 
alignment of the printer forms be checked before the data set is printed, 

//PUNCH DD UNIT=3525,FCB=DP2 

In this example, the DD statement requests output on a 3525. Therefore, the FCB parameter 
defines the data protection image to be used for the 3525. 

//SYSUDUMP DD SYSOUT=A, FCB=STD3 

In this example, the DD statement requests that the 3800 print a dump at 8 lines per inch. 
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FLASH Parameter 



Parameter Type: Keyword, optional 

Purpose: Use the FLASH parameter to identify the forms overlay to be used in printing this 
sysout data set on a 3800 Printing Subsystem and, optionally, to specify the number of copies 
on which the forms overlay is to be printed. 

Note: FLASH is valid only for a data set printed on a 3800. 

References: For infomiation on forms overlays, see the Forms Design Reference Guide for the 
IBM 3800 Printing Subsystem. 



Syntax: 



FLASH= 



overlay-name 

( overlay-name [ , count ] ) 

NONE 



The count subparameter is optional. If you omit it, you can omit the parentheses. However, 
if you omit it, you must not code it as a null; for example, FLASH = (ABCD,) is invalid. 



Subparameter Definition 



Defaults 



overlay-name 

Identifies the forms overlay frame that the operator is to insert into the printer before 
printing begins. The name is 1 through 4 alphanumeric or national characters. 

count 

Specifies the number, through 255, of copies that JES is to flash with the overlay, 
beginning with the first copy printed. Code a count of to flash all copies. 

NONE 

Suppresses flashing for this data set. 

If FLASH = NONE is on a DD statement in a job to be executed at a remote node, JES3 
sets the overlay-name to zero before sending the job to the node. 



If you do not code a FLASH parameter or specify an installation default at JES2 or JES3 
initialization, forms are not flashed. 

If you specify an overlay-name without specifying a count or with a count of 0, all copies are 
flashed. That is, the default for count is 255. 
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Overrides 

A FLASH parameter on a sysout DD statement overrides an OUTPUT JCL FLASH 
parameter. 

Note: A null first subparameter is invalid in a FLASH parameter on a DD statement, but is 
permitted on an OUTPUT JCL statement. 

Relationship to Other Parameters 

Do not code the following parameters with the FLASH parameter. 



* 


DLM 


MSVGP 


AMP 


DSID 


PROTECT 


DATA 


DSNAME 


QNAME 


DDNAME 


DYNAM 


VOLUME 


DISP 


LABEL 





Relationship to COPIES Parameter: If this DD statement or a referenced OUTPUT JCL 
statement also contains a COPIES parameter, JES prints with the forms overlay the number of 
copies specified in one of the following: 

• COPIES = nnn, if the FLASH count is larger than nnn. For example, if COPIES = 10 and 
FLASH = (LTHD, 12) JES prints 10 copies, all with the forms overlay. 

• The sum of the group-values specified in the COPIES parameter, if the FLASH count is 
larger than the sum. For example, if COPIES = (,(2,3,4)) and FLASH = (LTHD,12) JES 
prints nine copies in groups, all with the forms overlay. 

• The count subparameter in the FLASH parameter, if the FLASH count is smaller than nnn 
or the sum from the COPIES parameter. For example, if COPIES = 10 and 

FLASH = (LTHD,7) JES prints seven copies with the forms overlay and three copies 
without. 

Relationship to Other Control Statements 

FLASH can also be coded on the following: 

• The OUTPUT JCL statement. 

• The JES3 //* FORMAT PR statement. 

• The JES2 /*OUTPUT statement. 

Verification of Forms Overlay Frame 

Before printing starts, JES does not verify that the operator inserted the correct forms overlay 
frame for flashing. 
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Printing without Flasliing 

To print without flashing, specify one of the following: 

• FLASH = NONE on the DD or OUTPUT JCL statement. 

• Omit the FLASH parameter on all of the statements for the data set and on all JES 
initialization statements. 

• For a sysout data set, omit the FLASH parameter on the DD statement and specify 
FLASH = (,0) on a referenced OUTPUT JCL statement. 

Example of the FLASH Parameter 

//DDl DD SYSOUT=A,COPIES=10,FLASH=(ABCD,5) 

In this example, JES issues a message to the operator requesting that the forms-overlay frame 
named ABCD be inserted into the printer. Then JES prints the first five copies of the data set 
with the forms-overlay and the last five copies without. 
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FREE Parameter 



Parameter Type: Keyword, optional 

Purpose: Use the FREE parameter to specify when the system is to deallocate the resources 
used for this DD statement's data set. The resources can be devices, volumes, or exclusive use 
of a data set. 

Use FREE = CLOSE on a sysout DD statement to make JES print the sysout data set before 
the job is finished. 

Syntax: 




Subparameter Definition 

END 



Defaults 



Requests that the system deallocate the data set at the end of the step. 

CLOSE 

Requests that the system deallocate the data set when it is closed. 



If no FREE parameter is specified, the default is END. Also, if the FREE parameter is 
incorrectly coded, the system substitutes END and issues a warning message. 

Overrides 

FREE = CLOSE is ignored when: 

• The data set is a member of a concatenated group. 

• The task using the data set abnormally terminates. 

• The data set is referenced by another DD statement in the same or subsequent step. 

Relationship to Other Parameters 

Do not code the following parameters with the FREE parameter. 



* 


DLM 


DATA 


DYNAM 


DDNAME 


QNAME 



If the DD statement specifies FREE = END and a DISP subparameter of PASS, the data set is 
not deallocated until the end of the job or until used for a later DD statement with a 
disposition of other than PASS. 
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Do not specify FREE = CLOSE on a DD statement with a ddname of JOBCAT, JOBLIB, 
STEPCAT, or STEPLIB; CLOSE is ignored. 

Relationship to Other Control Statements 

If a DD statement requests unit affinity in a UNIT = AFF parameter or volume affinity in a 
VOLUME = REF parameter with an earlier DD statement, do not code FREE = CLOSE on the 
earlier statement. 

If you code FREE = CLOSE on a sysout DD statement that references an OUTPUT JCL 
statement containing a GROUPID parameter, JES2 will not group the data sets into one 
output group. Instead, JES2 produces one copy of the sysout data set for each OUTPUT JCL 
statement that the DD statement references. 

Relationship to the CLOSE Macro Instruction 

When FREE = CLOSE is specified for a data set that is opened and closed more than once 
during a job step: 

# The data set is deallocated after it is closed if the assembler CLOSE macro instruction 
specifies DISP, REWIND, or FREE. If the data set is reopened after the system has 
deallocated it, the job step abnormally terminates, unless the data set is dynamically 
allocated in the interval. 

• The data set is not deallocated until the end of the job step if the assembler CLOSE macro 
instruction specifies LEAVE or REREAD. Then the data set can be reopened. 

Examples of the FREE Parameter 



//EA33 DD SYSOUT=D,FREE=CLOSE 

In this example, the FREE = CLOSE parameter makes JES deallocate this output class D data 
set when it is closed, rather than at the end of the job step. JES schedules the data set for 
printing. 

//EA33 DD DSNAME=SYBIL,DISP=OLD,FREE=CLOSE 

In this example, the FREE = CLOSE parameter makes JES deallocate the data set, dequeue it, 
and make it available to other jobs as soon as it is closed. 

//STEPl EXEC PGM=ABLE1 

//DDl DD DSNAME=A,DISP=( ,PASS) ,FREE=END 

//STEP2 EXEC PGM=ABLE2 

//DD2 DD DSNAME=A,DISP=(OLD,CATLG) ,FREE=END 

In this example, data set A is passed by STEPl to STEP2. FREE = END on DD statement 
DDl is ignored because the disposition is PASS. FREE = END on DD statement DD2 causes 
data set A to be deallocated at the end of STEP2, when it is also cataloged. 
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//STEPl EXEC PGM=BAKER1 

//DD DD DSNAME=A, DISP=( NEW, PASS ) ,FREE=END 

//STEP2 EXEC PGM=BAKER2 

In this example, data set A is a new data set. Because PASS is specified, FREE = END is 
ignored and the data set remains allocated. 
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HOLD Parameter 



Parameter Type: Keyword, optional 

Purpose: Use the HOLD parameter to tell the system to hold a sysout data set until it is 
released by the system operator. When the data set is ready for processing, notify the system 
operator to release it via a TSO NOTIFY parameter, a JES2 /*MESSAGE statement, or a 
JES3 //*OPERATOR statement. 

A TSO user can specify HOLD = YES in order to retrieve a sysout data set and display it on a 
terminal. 

Note: HOLD is supported only for sysout data sets. If HOLD appears on a DD statement 
that does not contain a SYSOUT parameter, it is ignored. 

Syntax: 




Subparameter Definition 

YES 



Defaults 



Overrides 



Requests that the system hold the sysout data set until the data set is released by the 
system operator. This subparameter can also be coded as Y. 

NO 

Requests that system perform the installation-defined processing for the sysout data set's 
output class. This subparameter can also be coded as N. 



If no HOLD parameter is specified, the default is NO. If the HOLD parameter is incorrectly 
coded, the system assumes the default of NO and issues a warning message; the job continues. 



HOLD = NO is overridden by the deallocation verb of dynamic allocation or the TSO FREE 
command. 



Relationship to Other Parameters 



Do not code the following parameters with the HOLD parameter. 

* DLM 

DATA DYNAM 
DDNAME QNAME 
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Relationship to Other Control Statements 

Code a NOTIFY parameter on the JOB statement to ask the system to send a message to your 
TSO userid when job processing is complete. 

JES2 users can use the /*NOTIFY control statement to direct job notification messages and to 
override a JOB NOTIFY parameter. 

Example of the HOLD Parameter 



//JOBOl JOB , 'HAROLD DUQUETTE' ,MSGLEVEL=1 

//STEPl EXEC PGM=MJCOSCO 

//DDl DD SYS0UT=B,DEST=RMT6,H0LD=YES 

Sysout data set DDl from JOBOl is held on a queue until the TSO user at RMT6 asks the 
system operator to release the data set. 
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LABEL Parameter 



Parameter Type: Keyword, optional 

Purpose: Use the LABEL parameter to specify for a tape or direct access data set: 

• The type and contents of the label or labels for the data set. 

• If a password is required to access the data set. 

• If the system is to open the data set only for input or output. 

• The expiration data or retention period for the data set. 

For a tape data set, this parameter can also specify the relative position of the data set on the 
volume. 

References: For details on tape labels, see Magnetic Tape Labels and File Structure 
Administration. For details on direct access labels, see Data Administration Guide. For 
information on protecting a data set with a password, see System-Data Administration. 

Syntax: 



LABEL= [data-set-sequence-number] 



, label 



, PASSWORD 
,NOPWREAD 



,OUT 



,RETPD=nnnn 
,EXPDT=yyddd 



label is one of the following: 
SL 
SUL 
AL 
AUL 
NSL 
NL 
BLP 
LTM 



The first four subparameters are positional; the last subparameter is keyword. If you omit any positional 
subparameters but code a following positional subparameter, indicate each omitted subparameter by a 
comma. If the following subparameter is EXPDT or RETPD, commas are not needed to indicate omitted 
subparameters. For example: 

LABEL = (0001 ,SUL,PASSWORD,IN,EXPDT = 99365) 

LABEL = (,SUL,PASSWORD,EXPDT = 99365) 

LABEL = (,SUL„IN,EXPDT = 99365) 

LABEL - („PASSWORD,EXPDT = 99365) 

LABEL = (,SUL,EXPDT = 99365) 

LABEL = (0001,„IN) 

LABEL = (000 1 , EXPDT = 99365) 

If you specify only the data-set-sequence-number or only the retention period or only the expiration date, 
you can omit the parentheses. For example, code LABEL = data-set-sequence-number or 
LABEL = RETPD = nnnn or LABEL = EXPDT = yyddd. 
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Subparameter Definition 

Data-Set-Sequence-Number 

data-set-sequence-number 

Identifies the relative position of a data set on a tape volume. The 
data-set-sequence-number is 1 through 4 decimal digits. Omit this subparameter or code 
or 1 to indicate the first data set on the tape volume. 

Omit this subparameter for the following: 

• Cataloged data sets. The system obtains the data-set-sequence-number from the 
catalog. 

• A DD DSNAME parameter that requests all members of a generation data group 
(GDG). The system retrieves the data-set-sequence-number from the catalog. 

• A data set passed from a preceding step. The system obtains the 
data-set-sequence-number from the passing step. 

Label 

The system does not retain label type information for cataloged data sets; if the label type is 
not coded in the LABEL parameter for a cataloged data set, the system assumes SL. 

For a data set on a direct access device, the system obtains the label type from the DD 
statement; the label type is not obtained from any other source referred to in the DD 
statement. Only two label types are valid for direct access devices: SL and SUL, 

SL 

Indicates that a data set has IBM standard labels. If this subparameter is omitted, SL is 
the default. 

Code only SL or SUL for data sets on direct access devices. 

If the LABEL parameter is coded on a SYSCKEOV DD statement, code LABEL = (,SL). 

SUL 

Indicates that a data set has both IBM standard and user labels. 

Code only SL or SUL for data sets on direct access devices. 

Do not code SUL for partitioned or indexed sequential data sets. 



AL 



Indicates that a tape data set has ISO/ ANSI Version 1 or ISO/ANSI/FIPS Version 3 
labels. 

If you specify AL for a tape generation data set for output, the ending .GnnnnVnn (where 
n = through 9) will not appear as part of the file identifier (data set name field) of the 
HDRl label. Instead, the data is placed in the generation and version number fields of 
the HDRl label. 
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AUL 

Indicates that a tape data set has user labels and ISO/ ANSI Version 1 or ISO/ANSI/FIPS 
Version 3 labels. 

NSL 

Indicates that a tape data set has nonstandard labels. 

NL 

Indicates that a tape data set has no labels. 

When retrieving two or more data sets from several NL or BLP tape volumes, 
concatenate the DD statements and repeat the LABEL parameter on each DD statement. 

If you are processing ASCII data on unlabeled tapes, the data control block must specify 
OPTCD = Q. 

BLP 

Requests that the system bypass label processing for a tape data set. 

If the installation did not specify the BLP feature in the reader cataloged procedure, BLP 
has the same effect as NL. 

If you code BLP and the tape volume has labels, a tapemark delimits the data set. To let 
the system position a tape with labels to the proper data set, code the 
data-set-sequence-number subparameter; the number must reflect all labels and data sets 
that precede the desired data set. 

Do not specify BLP when the DD DSNAME parameter requests all members of a 
generation data group (GDG); the system obtains the data-set-sequence-number from the 
catalog. Therefore, coding BLP might result in incorrect tape positioning. 

When retrieving two or more data sets from several NL or BLP tape volumes, 
concatenate the DD statements and repeat the LABEL parameter on each DD statement. 

LTM 

Indicates that the data set has a leading tapemark. 

Password Protection 

Password protecting data sets requires the following: 

9 Data set names no longer than 17 characters. MVS retains in the tape label only the 
rightmost 17 characters of the data set name. Consequently, longer names could be 
identical in password checks. 

• Volumes with IBM standard labels or ISO/ANSI/FIPS Version 3 labels. 

• A password assigned in the PASSWORD data set. If a password is not assigned, the 
system will abnormally terminate a job step when it attempts to open the data set for 
output, if NOPWREAD is coded, or for input or output, if PASSWORD is coded. 

To create a password-protected data set following an existing password-protected data set, code 
the password of the existing data set. The password must be the same in both the existing and 
the new data set. 
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To password-protect a data set on a tape volume containing other data sets, you must 
password-protect all the data sets on the volume and the passwords must be the same for all 
data sets. 

To password-protect an existing data set using PASSWORD or NOPWREAD, open the data 
set for output the first time it is used during the job step. 

PASSWORD 

Indicates that a data set cannot be read, changed, deleted, or written to unless the system 
operator or TSO user supplies the correct password. 

NOPWREAD 

Indicates that a data set cannot be changed, deleted, or written to unless the system 
operator or TSO user supplies the correct password. No password is necessary for 
reading the data set. 



Input or Output Processing 

IN 



Indicates that a BSAM data set opened for INOUT or a BDAM data set opened for 
UPDAT is to be read only. The IN subparameter overrides the processing option in the 
assembler OPEN macro instruction. Any attempt by the processing program to write in 
the data set makes the system give control to the error analysis (SYNAD) routine. 

OUT 

Indicates that a BSAM data set opened for OUTIN or OUTINX is to be written in only. 
The OUT subparameter overrides the processing option in the assembler OPEN macro 
instruction. Any attempt by the processing program to read the data set makes the 
system give control to the error analysis (SYNAD) routine. 



Expiration Date for Data Set 



If the DD statement contains DISP = (NEW,DELETE) or the DISP parameter is omitted to 
default to NEW and DELETE, the system deletes the data set when the step terminates 
normally or abnormally, even though an RETPD period or EXPDT date is also specified. 

Do not specify or imply RETPD or EXPDT for a temporary data set. 

Expiration dates for successive files on an ISO/ANSI/FIPS Version 3 volume must be coded in 
descending order. For example, a data set with an expiration date of December 7, 1984 
(LABEL = EXPDT = 84342) should be followed by a data set with an expiration date of 
December 6, 1984 (LABEL = EXPDT = 84341) or earlier. 

Note: Do not try to protect valuable data with the RETPD and EXPDT subparameters. 
Instead, use password protection or the Resource Access Control Facility (RACF) for data 
protection. 

RETPD = nnnn 

Specifies the retention period, in days, for the data set. The nnnn is 1 through 4 decimal 
digits. After nnnn days, the data set can be deleted or written over by another data set. 

The system adds nnnn to the current date to produce an expiration date. If the calculated 
date is after January 1, 2000, the system will retain the data set only to January 1, 2000. 
The calculated expiration date uses 365-day years, ignoring leap years. 
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EXPDT = yyddd 

Specifies an expiration date for the data set. The yy is a two-digit year number and the 
ddd is a three-digit day number from 001 through 366. For example, code February 2, 
1986 as EXPDT = 86033. 



Defaults 



• If no data-set-sequence-number subparameter is specified or if the number is coded as or 
1, the default is the first data set on the tape volume, unless the data set is passed or 
cataloged. 

• If no label type subparameter is specified, the default is only IBM standard labels (SL). 

Relationship to Other Parameters 

Do not code the following parameters with the LABEL parameter. 

* DATA FLASH QNAME 

BURST DDNAME MODIFY SYSOUT 

CHARS DLM OUTLIM 

COPIES DYNAM OUTPUT 

Do not specify the LABEL parameter with the FUNC subparameter of the DCB parameter. 
The results are unpredictable. 

ISO/ANSI/FIPS Version 3 tape data sets can be protected by use of the ACCODE parameter. 

If you specify a LABEL parameter on a SYSCKEOV DD statement, code LABEL = (,SL). 

Relationship to Other Control Statements 

When a VOLUME = REF subparameter refers to an earlier DD statement to use the same 
volume(s): 

• For tape, the system copies the LABEL label type subparameter from the referenced DD 
statement; the copied label type overrides the label type on the referencing DD statement. 

• For direct access, the system uses a LABEL = (,SL) or LABEL = (,SUL) subparameter from 
the referencing DD statement. If the referencing DD statement specifies any other label 
type, the system copies the LABEL label type subparameter from the referenced DD 
statement; the copied label type overrides the label type on the referencing DD statement. 

Deleting a Data Set Before its Expiration Date 

To delete a data set before the expiration date or retention period has passed, use one of the 
following: 

• For data sets cataloged in a VSAM or ICF catalog, use the DELETE command, as 
described in Integrated Catalog Administration: Access Method Services Reference or VSAM 
Catalog Administration: Access Method Services Reference. 
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• For data sets not cataloged in a VSAM or ICF catalog, use the lEHPROGM utility, as 
described in Data Administration: Utilities. 

• For the data set control block (DSCB), use the SCRATCH macro with the OVRD 
parameter, as described in System-Data Administration. Deletion of the DSCB makes the 
space occupied by the data set available for reallocation. 

Translation 

If the installation specified ASCII = INCLUDE during system generation, then AL or AUL in 
the LABEL parameter requests translation. You can also request translation by specifying 
OPTCD = Q in the data control block. If the tape is not labeled, LABEL = (,NL), you must 
specify OPTCD = Q for translation to occur. 

Examples of the LABEL Parameter 



//DDl DD DSNAME=HERBI, DISP=( NEW, KEEP ) ,UNIT=TAPE, 
// V0LUME=SER=T2 , LABEL= ( 3 , NSL , RETPD= 188 ) 

This DD statement defines a new data set. The LABEL parameter tells the system: 

• This data set is to be the third data set on the tape volume. 

• This tape volume has nonstandard labels. 

• This data set is to be kept for 188 days. 



//DD2 DD DSNAME=A.B.C,DISP=(,CATLG, DELETE) ,UNIT=3400-5 ,LABEL= ( ,NL) 

This DD statement defines a new data set, requests that the system catalog it, and indicates that 
the data set has no labels. Each time this data set is used by a program, the DD statement 
must include LABEL = (,NL). 
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//DD3 DD DSNAME=SPECS,UNIT=3400-5,VOLUME=SER=10222, 
// DISP=0LD,LABEL=4 

This DD statement indicates an existing data set. The LABEL parameter indicates that the 
data set is fourth on the tape volume. 

//STEPl EXEC PGM=FIV 

//DDX DD DSNAME=CLEAR, DISP=( OLD, PASS ) ,UNIT=3400-5, 

// VOLUME=SER=1257,LABEL=( ,NSL) 

//STEP2 EXEC PGM=BOS 

//DDY DD DSNAME=*. STEPl. DDX, DISP=OLD, LABEL= ( ,NSL) 

DD statement DDX in STEPl indicates an existing data set with nonstandard labels and 
requests that the system pass the data set. DD statement DDY in STEP2 receives the data set. 
DDY contains the label type, because the system does not obtain the label type through the 
backward reference in the DSNAME parameter. 

//DDZ DD DSNAME=CATDS,DISP=OLD,LABEL=( /SUL) 

This DD statement indicates an existing, cataloged data set on direct access. The data set has 
IBM standard labels and user labels. The LABEL parameter is required; otherwise, if the DD 
statement does not contain a LABEL parameter, the system assumes that a direct access data 
set has SL labels. 
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MODIFY Parameter 



Parameter Type: Keyword, optional 

Purpose: Use the MODIFY parameter to specify a copy-modification module that tells JES 
how to print this sysout data set on a 3800 Printing Subsystem. The module can specify the 
following: 

• Legends. 

• Column headings. 

• Where and on which copies the data is to be printed. 

The module is defined and stored in SYSl.IMAGELIB using the lEBIMAGE utility program. 

Note: MODIFY is supported only for the 3800 Printing Subsystem Model 1 and 2 and the 
3800 Printing Subsystem Model 3 in compatibility mode. 

References: For more information on the copy modification module and the lEBIMAGE 

utiUty program, see Data Administration: Utilities. 

Syntax: 



MODIFY= Imodule-name 

(module-name [ ,trc] ) 



• You must code the module-name. 

• The trc subparameter is optional. If you omit it, you can omit the parentheses. 
However, if you omit it, you must not code it as a null; for example, 
MODIFY = (TAB 1,) is invalid. 



Subparameter Definition. 



module-name 

Identifies a copy-modification module in SYSl.IMAGELIB. The module-name is 1 
through 4 alphanumeric or national characters. 



trc 



Identifies which table-name in the CHARS parameter is to be used. This table reference 
character is for the first table-name specified, 1 for the second, 2 for the third, or 3 for 
the fourth. The CHARS parameter is on the following, in override order: 

1. This DD statement. 

2. A referenced OUTPUT JCL statement. 

3. A statement in the Ubrary member specified on the OUTPUT JCL PAGEDEF 

parameter. 

4. A statement in the SYSl.IMAGELIB member obtained by default. 

5. A JES3 initialization statement. 
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Defaults 



If no MODIFY parameter is specified, JES3 uses an installation default specified at 
initialization. JES2 provides no installation default at initialization. 

If you do not specify trc or if the trc value is greater than the number of table-names in the 
CHARS parameter, JES2 uses the first table named in the CHARS parameter and JES3 uses 
the default character arrangement table. 



Overrides 



A MODIFY parameter on a sysout DD statement overrides an OUTPUT JCL MODIFY 

parameter. 

Note: A null first subparameter is invalid in a MODIFY parameter on a DD statement, but is 
permitted on an OUTPUT JCL statement. 

Relationship to Other Parameters 

Do not code the following parameters with the MODIFY parameter. 



* 


DLM 


MSVGP 


AMP 


DSID 


PROTECT 


DATA 


DSNAME 


QNAME 


DDNAME 


DYNAM 


VOLUME 


DISP 


LABEL 





Relationship to Other Control Statements 

MODIFY can also be coded on the following: 

• The OUTPUT JCL statement. 

• The JES3 //*FORMAT PR statement. 

• The JES2 /*OUTPUT statement. 

The second character of each logical record can be a TRC code, so that each record can be 
printed in a different font. This way of specifying fonts is indicated by the OUTPUT JCL TRC 
parameter. 

Example of the MODIFY Parameter 



//DDl DD UNIT=3800,MODIFY=(A,0) ,CHARS=(GS15,GS10) 

In this example, the MODIFY parameter requests that the data in the copy-modification 
module named A replace variable data in the data set to be printed by the 3800. Module A 
defines which positions are to be replaced and which copies are to be modified. The second 
subparameter in MODIFY specifies that the first character arrangement table in the CHARS 
parameter, GS15, be used. 
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MSVGP Parameter 



Parameter Type: Keyword, optional 

Purpose: Use the MSVGP parameter to place the data set in a group of mass storage volumes 
on a mass storage system (MSS) device. MSVGP applies only to a nonspecific volume request, 
which is a DD statement for a new data set that can be assigned to any volume or volumes. 

References: For information on defining mass storage groups, see Mass Storage System 
(MSS) Services General Information. 

Syntax: 



MSVGP= 



id 

( id[ ,ddnanie] ) 

SYSGROUP 



You can omit the parentheses if you code only the id subparameter or SYSGROUP. 



Subparameter Defmition 
id 



Identifies a group of mass storage volumes. The id is 1 through 8 alphanumeric or 
national characters and must be previously defined by the installation using a mass 
storage system service. 

ddname 

Requests that the data set for this DD statement is to be allocated to volume(s) other 
than the volume(s) occupied by the data set for DD statement ddname. DD statement 
ddname must appear earlier in the job step. 

If volume separation within the group is not possible, the system terminates the job. 

The ddname refers to only the first data set (1) when the named DD statement starts a 
concatenation or (2) when the DSNAME parameter of the named DD statement requests 
all members of a generation data group (GDG). 

SYSGROUP 

Identifies a default group of mass storage volumes. Code MVSGP = SYSGROUP to 
make sure that a nonspecific request is allocated to SYSGROUP. 
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Relationship to Other Parameters 

Do not code the following parameters with the MSVGP parameter. 

* DDNAME MODIFY 

BURST DLM OUTLIM 

CHARS DSID OUTPUT 

COPIES DYNAM QNAME 

DATA FLASH SYSOUT 

SPACE Parameter: Code the SPACE parameter for the following reasons: 

• To allocate noncontiguous primary space. Contiguous space is the MSVGP default. 

• For nonspecific requests for BPAM and ISAM data sets. 

Do not code the ABSTR, MXIG, and ALX subparameters in the SPACE parameter. 

VOLUME Parameter: Do not code VOLUME = SER with the MSVGP parameter; 
VOLUME = SER is a specific volume request, while MSVGP can be used only for nonspecific 
volume requests. 

VOLUME = PRIVATE with MSVGP is redundant, because MSVGP causes allocation to a 
private volume. 

UNIT and VOLUME Counts: The unit count in the UNIT parameter must be less than the 
volume count in the VOLUME parameter to guarantee allocation of a unit that is not shared 
with another job. 

Aliocation when MSVGP is Not Coded 

When a DD statement defines a new, nonspecific data set to be placed on an MSS device and 
does not contain an MSVGP parameter, the system allocates as follows: 

• Places a permanent data set on a mounted 3330V Disk Storage volume, if one exists. If 
one does not exist, a volume is selected from SYSGROUP; in this case, the DD statement 
must contain a SPACE parameter or the job is terminated. 

• Places a temporary data set on a mounted 3330V Disk Storage public volume, if one exists. 
If one does not exist or it does not have enough space, a volume is selected from 
SYSGROUP. 
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Examples of the MSVGP Parameter 



//DDl DD DSNAME=ACCOUNT,DISP=(NEW,CATLG) ,UNIT=3330V, 
// MSVGP=AB$12 34@,VOLUME=( , , ,,3) 

A new, cataloged data set is to be created on one, two, or three mass storage volumes in the 
group called AB$1234@. The installation previously defined this group and assigned at least 
three volumes to it. If the installation provided a space default of SPACE = (CYL,(200, 100)), 
the system selects from the group a volume with at least 200 cylinders available. 

During step execution, if more than 200 cyUnders are required, and if 100 more cylinders are 
not available on the mounted volume, the system asks the operator to demount the volume. 
The system selects from group AB$1234@ a volume with at least 100 cyhnders available and 
asks the operator to mount the volume. The volume count of three allows the data set to 
extend over three volumes. If more are required, the step abnormally terminates. 

//DDl DD DSNAME=MASTRIN,DISP=OLD 

//DD2 DD DSNAME=MASTROUT,UNIT=3330V,DISP=( ,CATLG) , 

// MSVGP=(AB$1234(a,DDl) 

DDl requests an existing cataloged data set. DD2 defines a new data set that will be allocated 
to a volume in mass storage group AB$I234@. 

Because DDl is specified as the ddname subparameter of MSVGP on DD2, the system 
allocates the DD2 data set, MASTROUT, to different volumes than the volumes for the DDl 
data set, MASTRIN. 
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OUTLIM Parameter 



Parameter Type: Keyword, optional 

Purpose: Use the OUTLIM parameter to limit the number of logical records in the sysout data 
set defined by this DD statement. When the limit is reached, the system exits to the SYSOUT 
Umit exit routine. If the installation supplies a user-written routine, the routine can determine 
whether to terminate the job or increase the limit. If the installation does not supply a routine, 
the system terminates the job. 

If the installation supplies a routine, it must be in the SYSl.LPALIB library. 

Note: OUTLIM is valid only on a DD statement with a SYSOUT parameter. 

References: For more information on the SYSOUT limit exit routine, see SPL: System 
Management Facilities. 

Syntax: 



OUTLIM=number 



Subparameter Definition 



number 

Specifies the maximum number of logical records. The number is 1 through 8 decimal 
digits from 1 through 16777215. 



Default 



(1) If no OUTLIM parameter is specified or OUTLIM = is coded and (2) if output is not 
limited by JES control statements, JES3 uses an installation default specified at initialization; 
JES2 provides no installation default at initiahzation. 

Relationship to Other Parameters 

OUTLIM can be coded only when SYSOUT is also coded. 

Do not code the following parameters with the OUTLIM parameter. 



* 


DISP 


MSVGP 


UNIT 


AMP 


DLM 


PROTECT 


VOLUME 


CHKPT 


DSNAME 


QNAME 




DATA 


DYNAM 


SPACE 




DDNAME 


LABEL 


SUBSYS 





Do not code the OUTLIM parameter with the DCB subparameters CPRI or THRESH; these 
subparameters can alter the OUTLIM value. 

On Dump DD Statements: JES3 ignores an OUTLIM parameter on a SYSABEND or 
SYSUDUMP DD statement. 
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Relationship to Other Control Statements 

Output can also be limited by the following: 

• The LINES, BYTES, or PAGES parameters of the JES2 /* JOBPARM statement. 

• The LINES or CARDS parameters of the JES3 //*MAIN statement. 

Example of the OUTLIM Parameter 

//OUTDD DD SYSOUT=F,OUTLIM=1000 

The limit for the number of logical records is 1000. 
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OUTPUT Parameter 



Parameter Type: Keyword, optional 

Purpose: Use the OUTPUT parameter with the SYSOUT parameter to associate a sysout data 
set explicitly with an OUTPUT JCL statement. JES processes the sysout data set using the 
options from this DD statement combined with the options from the referenced OUTPUT JCL 
statement. 

When the OUTPUT parameter references more than one OUTPUT JCL statement, the system 
produces separate output for each OUTPUT JCL statement. 

Note: Code the OUTPUT parameter only on a DD statement with a SYSOUT parameter. 
Otherwise, the system checks the OUTPUT parameter for syntax then ignores it. 



Syntax: 



OUTPUT= 



reference 

(reference [ , reference] . . . ) 



A reference is one of the following: 

* . name 

* . stepname . name 

* . stepname. procstepname. name 



• You can omit the parentheses if you code only one reference. 

• You must not code a null in an OUTPUT parameter. For example, 
OUTPUT = (,*. name) is invalid. 

• You can reference a maximum of 128 OUTPUT JCL statements on one OUTPUT 
parameter. 

• You can code references in any combination. For example, the following are valid: 

//EXA DD SYSOUT=A,OUTPUT=(*. name,*. name,* .stepname. name) 
//EXB DD SYSOUT=A,OUTPUT=(*. stepname. name, 
// * . stepname. procstepname. name, * .name) 

• You can code the references to OUTPUT JCL statements in any order. 
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Subparameter Definition 



Defaults 



Overrides 



*.naine 

Refers to an earlier OUTPUT JCL statement with name in its name field. The system 
searches for the OUTPUT JCL statement first in the same step, then before the first 
EXEC statement of the job. 

*.stepname.name 

Refers to an earlier OUTPUT JCL statement, name, in this step or an earUer step, 
stepname, in the same job. 

*.stepname.procstepname.name 

Refers to an OUTPUT JCL statement in a cataloged or in-stream procedure. Stepname 
is the name of this job step or an earlier job step that calls the procedure, procstepname is 
the name of the procedure step that contains the OUTPUT JCL statement, and name is 
the name field of the OUTPUT JCL statement. 



If you do not code an OUTPUT parameter on a sysout DD statement, JES obtains processing 
options for the sysout data set in the following order: 

L From each OUTPUT JCL statement containing DEFAULT = YES in the same step. 

2. From each OUTPUT JCL statement containing DEFAULT = YES before the first EXEC 
statement in the job, provided that the step contains no OUTPUT JCL statements with 
DEFAULT = YES. 

3. Only from the sysout DD statement, provided that neither the step nor job contains any 
OUTPUT JCL statements with DEFAULT = YES. 



When an qutpUT JCL statement is used with the sysout DD statement to specify processing, 
JES handles parameters as follows: 



• If a parameter appears on the DD statement, JES uses the parameter. 

• If a parameter appears only on the OUTPUT JCL statement, JES uses the parameter. 

• If the same parameter appears on both statements, JES uses the DD parameter. 

JES uses the whole overriding parameter, ignoring the whole overridden parameter. If a 
subparameter is left off the overriding parameter, the system does not pick up that 
subparameter from the overridden parameter. For example: 



//EXAMP2 OUTPUT 
//FVZ2 DD 



FLASH=(ABCD,3) 

SYSOUT=F , OUTPUT=* . EXAMP2 , FLASH= ( EFGH ) 



Only EFGH is used. The system ignores all of the FLASH parameter on the OUTPUT JCL 
statement, including the second parameter. 
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Relationship to Other Parameters 

OUTPUT can be coded only when SYSOUT is also coded. 

With INTRDR Subparameter in SYSOUT Parameter: Do not code an OUTPUT parameter 
when the SYSOUT parameter specifies a JES2 internal reader by an INTRDR parameter. 

Null Subparameters: A null first subparameter is invalid in a FLASH or MODIFY parameter 
on a DD statement, but is permitted on an OUTPUT JCL statement. For example, 
MODIFY = (,3) is valid only on an OUTPUT JCL statement. 

SYSOUT Third Subparameter: You cannot reference a JES2 /*OUTPUT statement using the 
third subparameter of the SYSOUT parameter if either of the following is also coded: 

• The OUTPUT parameter on the same DD statement. 

• An OUTPUT JCL statement containing DEFAULT = YES in the same step or before the 
EXEC statement of the job, when the DD statement does not contain an OUTPUT 
parameter. 

DEFA ULT Parameter on OUTPUT JCL Statement: If you code DEFAULT = YES on an 
OUTPUT JCL statement, you can still refer to that OUTPUT JCL statement in the OUTPUT 
parameter of a sysout DD statement. 

Location in the JCL 

All referenced OUTPUT JCL statements must precede the DD statement that refers to them. 
If the referencing DD statement appears in an in-stream or cataloged procedure, the referenced 
OUTPUT JCL statement must precede the DD statement in the procedure. A sysout DD 
statement in a procedure cannot refer to an OUTPUT JCL statement in the calling step. 

No Match for OUTPUT Name 

If the system finds no match for the name coded in the OUTPUT parameter, the system issues 
a JCL error message and fails the job. 

Processing Options in Multiple References 

A sysout DD statement can refer to more than one OUTPUT JCL statement, either explicitly 
in an OUTPUT parameter containing more than one reference or implicitly when several 
default OUTPUT JCL statements apply. The processing options for a sysout data set come 
from one sysout DD statement and one OUTPUT JCL statement. In multiple references, each 
combination of sysout DD statement and one of the referenced OUTPUT JCL statements 
produces a separate set of printed or punched output. 

Processing options are not cumulative across a group of OUTPUT JCL statements. 
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Examples of the OUTPUT Parameter 



//Jl JOB ,'MARY LUDWIG' 

//JOUT OUTPUT CLASS=C,F0RMS=RECP,INDEX=6 

//STEPl EXEC PGM=XYZ 

//SOUT OUTPUT CLASS=H,BURST=YES,CHARS=GT12,FLASH=BLHD 

//ALL DD SYSOUT=( , ) ,OUTPUT=(*, JOBOUT,*.STPOUT) ,C0PIES=5 

//IN DD * 

(data) 

/* 

The OUTPUT parameter references two OUTPUT JCL statements. Therefore, the system 
prints the single sysout data set twice: 

# For DD ALL combined with OUTPUT JOUT, the sysout data set is printed in class C. In 
the installation, output class C is printed on a 3211 Printer. Combining the parameters 
from the DD and OUTPUT JCL statements, the system prints 5 copies of the data set on 
form RECP and indents the left margin 5 spaces. 

• For DD ALL combined with OUTPUT SOUT, the sysout data set is printed in class H, In 
the installation, output class H is printed on a 3800 Printing Subsystem. Combining the 
parameters from the DD and OUTPUT JCL statements, the system prints 5 copies of the 
data set with the forms-overlay frame named BLHD using character-arrangement table 
GT12 and bursts the output. 



// J6 JOB , ' SUE THACKER ' 

//OUTA OUTPUT DEST=HQ 

//STEPl EXEC PGM=RDR 

//OUTB OUTPUT CONTROL=DOUBLE 

//DSl DD SYSOUT=A,OUTPUT=(*. OUTA,*. OUTB) 

//STEP2 EXEC PGM=WRT 

//OUTC OUTPUT DEST=ID2 742 

//DS2 DD SYSOUT=A,OUTPUT=(*. OUTC,*. STEPl. OUTB) 

The OUTPUT parameter on DSl references: 

• The job-level OUTPUT JCL statement OUTA to send the sysout data set to HQ. 

• The step-level OUTPUT JCL statement OUTB to print the sysout data set double-spaced 
on the local 3800 Printing Subsystem used for output class A. 

The OUTPUT parameter on DS2 references: 

• OUTPUT JCL statement OUTB in the first step to print the sysout data set double-spaced 
on the local 3800 Printing Subsystem used for output class A. 

• OUTPUT JCL statement OUTC in the same step to send the sysout data set to userid 
ID2742, which is attached to the local system. 

Note that the references to OUTPUT JCL statements are in no particular order. 
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PROTECT Parameter 



Parameter Type: Keyword, optional 

Use the PROTECT parameter only if RACF is installed and active. 

Note: Information for RACF Version 1 Release 7 tape data set protection only applies if you 
also have MVS/Extended Architecture Data Facility Product (DFP) Version 2 Release 1 .0 
installed. 

Purpose: Use the PROTECT parameter to tell the Resource Access Control Facility (RACF) 
to protect: 

• One data set on a direct access volume. 

• Beginning with RACF Version 1 Release 7, one data set on a tape volume with one of the 
following types of labels: 

IBM standard labels, LABEL = (,SL) or LABEL = (,SUL) 
ISO/ANSI/FIPS Version 3 labels, LABEL = (,AL) or LABEL = (,AUL) 
Nonstandard labels, LABEL = (,NSL), if the installation provides support 

• Beginning with RACF Version 1 Release 7, an entire tape volume with one of the 
following: 

IBM standard labels, LABEL = (,SL) or LABEL = (,SUL) 

ISO/ANSI/FIPS Version 3 labels, LABEL -(,AL) or LABEL = (,AUL) 

Nonstandard labels, LABEL = (,NSL), if the installation provides 

No labels, LABEL = (,NL) 

Bypassed label processing, LABEL = (,BLP) 

Leading tapemarks, LABEL = (,LTM) 

• With RACF Version 1 Release 6 and earlier releases, an entire tape volume with one of the 
following: 

IBM standard labels, LABEL = (,SL) or LABEL = (,SUL) 
ISO/ANSI/FIPS Version 3 labels, LABEL = (,AL) or LABEL = (,AUL) 

References: For more information on RACF, see Resource Access Control Facility (RACF) 
General Information Manual. 

Syntax: 
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Subparameter Definition 



YES 



Requests RACF to protect a direct access data set, tape data set, or tape volume. This 
parameter can also be coded as Y. 



Relationship to Other Parameters 



Do not code the following parameters with the PROTECT parameter. 



♦ 


DLM 


OUTPUT 


BURST 


DYNAM 


QNAME 


CHARS 


FCB 


SYSOUT 


DATA 


FLASH 


TERM 


DDNAME 


MODIFY 
OUTLIM 


UCS 



DSNAME Parameter for RACF-Protected Data Sets: RACF expects the data set name 
specified in the DSNAME parameter to have a high-level quaUfier that is defined to RACF. 
See the RACF Security Administrator's Guide for details. 

Requirements for Protecting a Tape Data Set 

Beginning with RACF Version 1 Release 7, a DD statement that contains a PROTECT 
parameter to establish RACF protection for a tape data set must: 

• Specify or imply VOLUME = PRIVATE. 

• Specify or imply DISP = NEW, DISP = OLD, or DISP = SHR; it must not specify or imply 
DISP = MOD. 

• Specify in the LABEL parameter a label type of: 

- SL or SUL for IBM standard labels. 

- AL or AUL for ISO/ ANSI Version 1 or ISO/ANSI/FIPS Version 3 tape labels. 

- NSL for nonstandard labels. In this case, the NSL installation exit routine must issue a 
RACDEF or RACROUTE TYPE = DEFINE macro instruction. See SPL: System 
Macros and Facilities for a description of these macro instructions. 

• Specify in the LABEL paramter a data-set-sequence-number, if the data set is not the first 
on the volume. 

Requirements for Protecting a Tape Volume 

Beginning with RACF Version 1 Release 7, a DD statement that contains a PROTECT 
parameter to estabUsh RACF protection for a tape volume must: 

• Specify or imply VOLUME = PRIVATE. 

• Specify or imply DISP = NEW. 
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• Specify in the LABEL parameter a label type of: 

- SL or SUL for IBM standard labels. 

- AL or AUL for ISO/ANSI Version 1 or ISO/ANSI/FIPS Version 3 tape labels. 

- NSL for nonstandard labels. In this case, the NSL installation exit routine must issue a 
RACDEF or RACROUTE TYPE = DEFINE macro instruction. 

- NL for no labels. 

- BLP for bypass label processing. 

- LTM for leading tapemark. 

Note that RACE cannot fully protect unlabeled tapes because RACE cannot verify the volume 
serial number directly; the operator must verify the volume serial number when mounting the 
tape volume. 

Requirements for Protecting a Tape Volume 

With RACE Version 1 Release 6 and eariier releases, a DD statement that contains a 
PROTECT parameter to estabhsh RACE protection for a tape volume must: 

• Name one of the volume's existing data sets in the DSNAME parameter. 

• Specify or imply VOLUME = PRIVATE. 

• Specify DISP = OLD. The status must not be MOD treated as OLD. 

• Specify in the LABEL parameter a label type of: 

- SL or SUL for IBM standard labels. 

- AL or AUL for ISO/ ANSI Version 1 or ISO/ANSI/FIPS Version 3 tape labels. 

• Must not already be protected. 

To estabhsh protection, the tape data set must be: 

• The first on the volume, except for NSL tapes. 

• Located on the first volume of a multivolume data set, except for NSL tapes. Thus, the 
volume-sequence-number of the VOLUME parameter must be 1 . 

• Opened for OUTPUT or OUTIN by the program. 
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Requirements for Protecting a Direct Access Data Set 

A DD statement that contains a PROTECT parameter to establish RACF protection for a 
direct access data set must: 

• Name a permanent data set in the DSNAME parameter. 

• Specify a status of DISP = NEW or MOD treated as NEW. RACF can estabhsh protection 
only when the data set is being created. 

• Specify a disposition of other than DELETE for either normal or abnormal termination. 
Examples of the PROTECT Parameter 



//DASD DD DSNAME=USER37.MYDATA,DISP=(,CATLG) , 

// VOLUME=SER=333000,UNIT=3330,SPACE=(TRK,2) ,PROTECT=YES 

This DD statement requests RACF protection for the new direct access data set 
USER37.MYDATA. 

//TAPEVOL DD DSNAME=MHB1 . TAPEDS , DISP= (NEW, KEEP ) ,LABEL= ( ,NL) , 
// VOLUME=SER=T49850,UNIT=3400-5,PROTECT=YES 

This DD statement requests RACF protection for tape volume T49850. Because a specific tape 
volmne is requested, it automatically has the PRIVATE attribute. The volume has no labels. 

//TAPEDS DD DSNAME=INST7.NEWDS,DISP=(NEW,CATLG) ,LABEL=(2,SUL) , 
// VOLUME=SER=223344,UNIT=3400-5,PROTECT=YES 

This DD statement requests RACF protection for INST7.NEWDS, which is the second data set 
on tape volume 223344. Because a specific tape volume is requested, it automatically has the 
PRIVATE attribute. The volume has IBM standard and user labels; the RACF Release 1.7 
TAPEDSN facility must be active. 
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QNAME Parameter 



Parameter Type: Keyword, optional 

Purpose: Use the QNAME parameter to indicate that this DD statement defines a data set of 
telecommunications access method (TCAM) messages. The QNAME parameter refers to a 
TPROCESS macro instruction that defines a destination queue for the messages. Optionally, 
the QNAME parameter can also name a TCAM job to process the messages. 

References: For information about TCAM and the TPROCESS macro instruction, see 
Advanced Communications Function for TCAM, Version 2, Installation Reference. 

Syntax: 



QNAME=procname [ .tcamname] 



Subparameter Definition 

procname 

Identifies a TPROCESS macro instruction; procname must be identical to the procname 
in the name field of the TPROCESS macro instruction. 

tcamname 

Names a TCAM job: tcamname must be identical to the jobname. The TCAM job can 
be a task started by an operator START command. 

Relationship to Other Parameters 

The only DD parameter that you can code with the QNAME parameter is the DCB parameter. 

The only DCB subparameters that you can code with the QNAME parameter are: BLKSIZE, 
BUFL, LRECL, OPTCD, and RECFM. 

Examples of the QNAME Parameter 



//DYD DD QNAME=FIRST,DCB=(RECFM=FB,LRECL=80,BLKSIZE=320) 

This DD statement defines a data set of TCAM messages. FIRST is the name of the 
TPROCESS macro instruction that specifies the destination queue to which the messages are 
routed. The DCB parameter supplies information not supplied in the program's DCB macro 
instruction for the data control block. 

//DXD DD QNAME=SECOND.TCAM01 

This DD statement defines a data set of TCAM messages. SECOND is the name of the 
TPROCESS macro instruction that specifies the destination queue to which the messages are 
routed. TCAM program TCAMOl will process the messages. 
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SPACE Parameter 



Parameter Type: Keyword, optional 

Purpose: Use the SPACE parameter to request space for a new data set on a direct access 
volume. You can request space in two ways: 

• Tell the system how much space you want and let the system assign specific tracks. 

# Tell the system the specific tracks to be allocated to the data set. 

Letting the system assign the specific tracks is most firequently used. You specify only how 
space is to be measured — in tracks, cylinders, or blocks — and how many of those tracks, 
cylinders, or blocks are required. 



The SPACE parameter has no meaning for tape volumes; however, if you assign a data set to a 
device class that contains both direct access devices and tape devices, for example, 
UNIT = SYSSQ, you should code the SPACE parameter. 

Syntax: 



For system assignment of space: 



SPACE= 



TRK, 
CYL, 
blklgth, 



primary-qty 



,second-qty 



, directory 
, index 



,RLSE 



,CONTIG 
,MXIG 
I AJ-jX 



[, ROUND] 



To request specific tracks: 
SPACE= /abSTR, (primary-qty, address 



, directory 
, index 



• You can omit the parentheses around the primary quantity if you do not code secondary, directory, or 
index quantities. For example, SPACE = (TRK,20,RLSE,CONTIG) or SPACE = (TRK,20). Note that, 
if you omit these inner parentheses, you also omit the commas within them. 

• All the subparameters are positional. Code a comma to indicate an omitted subparameter if any others 
follow. Thus: 

- If you code primary and directory or index quantities and omit a secondary quantity, code a 
comma inside the inner parentheses to indicate the omission. For example, SPACE = (TRK,(20„2)). 

- If you omit RLSE but code a following subparameter, code a comma to indicate the omission. For 
example, SPACE = (TRK,(20,10)„CONTIG) or SPACE = (TRK,20„CONTIG). 

- If you omit CONTIG, MXIG, or ALX and ROUND follows, code a comma to indicate the 
omission. For example, SPACE = (400,30,RLSE„ROUND). If RLSE is also omitted, this example 
becomes SPACE = (400,30,„ROUND). 
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Subparameter Definition 

System Assignment of Space 
TRK 



Requests that space be allocated in tracks. 

CYL 

Requests that space be allocated in cylinders. 

blklgth 

Specifies the average block length of the data. The system computes how many tracks to 
allocate. The blklgth is a decimal number from 1 through 65535. 

primary-qty 

Specifies one of the following: 

• For TRK, the number of tracks to be allocated. 

• For CYL, the number of cyUnders to be allocated. 

• For a block length, the number of data blocks in the data set. 

Note: When you specify TRK or CYL for a partitioned data set, the primary quantity 
includes the space for the directory. When you specify a block length for a partitioned 
data set, the primary quantity does not include the directory space; the system assigns the 
directory to space outside the primary space assignment. 

One volume must have enough available space for the primary quantity. If you request a 
particular volume and it does not have enough space available for your request, the 
system terminates the job step. Allow for track overflow when computing track 
requirements. 

To request an entire volume, specify in the primary quantity the number of tracks or 
cylinders on the volume minus the number used by the volume table of contents (VTOC). 
The volume must not contain other data sets. 

second-qty 

Specifies the number of additional tracks, cyhnders, or blocks to be allocated, if more 
space is needed. The system does not allocate additional space until it is needed. 

If the first subparameter specifies the average block length, the system computes the 
number of tracks for the secondary quantity from the second-qty number multiphed by 
one of the following, in order: 

1. The block length in the BLKSIZE field of the data control block. 

2. The BLKSIZE parameter in the DCB macro instruction. 

3. The SPACE average block length subparameter. 

When you specify a secondary quantity and the data set requires additional space, the 
system allocates the specified quantity: 

1. In contiguous tracks or cylinders, if available. 

2. If not, in up to five extents. 



1 0- 1 22 MVS/XA JCL Reference 



DD: SPACE 



The system can allocate up to 16 extents for a data set on a volume. An extent is space 
that may or may not be contiguous to other space allocated to the data set. The extents 
for a data set include the primary quantity space and user-label space. 

Note: BDAM data sets cannot be extended. 

Each time the data set requires more space, the system allocates the secondary quantity. 
This space is allocated on the same volume as the primary quantity until one of the 
following occurs: 

• The volume does not have enough space available for the secondary quantity. 

• 16 extents have been allocated to the data set. 

Then, the system allocates the secondary quantity on another volume. If the requested 
volumes have no more available space and if at least one volume is demountable, the 
system asks the operator to mount scratch (nonspecific) volumes until the secondary 
allocation is complete. If none of the volumes are demountable, the system abnormally 
terminates the job step. 

directory 

Specifies the number of 256-byte records needed in the directory of a partitioned data set. 

Note: When creating a partitioned data set, you must request space for a directory. 

index 

For the index of an indexed sequential data set, specifies one of the following: 

• For TRK, the number of tracks needed. The number of tracks must equal one or 
more cylinders. 

• For CYL, the number of cylinders needed. 

RLSE 

Requests that space allocated to an output data set, but not used, is to be released when 
the data set is closed. Unused space is released only if the data set is open for output and 
the last operation was a write. 

If you specify RLSE and an abnormal termination occurs, the system does not release 
unused space even though the data set is open. 

The system ignores a request to release unused space when a data set is closed if: 

• Another job is sharing the data set. 

• Another task in the same job is processing an OPEN, CLOSE, EOV, or FEOV 
request for the data set. 

• Another data control block is open for the data set. 

The RLSE subparameter is ignored when TYPE = T is coded in the CLOSE macro 
instruction. 
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CONTIG 

Requests that space allocated to the data set must be contiguous. This subparameter 
affects only primary space allocation. 

If CONTIG is specified and contiguous space is not available, the system terminates the 
job step. 

MXIG 

Requests that space allocated to the data set must be (1) the largest area of available 
contiguous space on the volume and (2) equal to or greater than the primary quantity. 
This subparameter affects only primary space allocation. 

Note: Do not code a MXIG subparameter for an indexed sequential data set. 

ALX 

Requests that up to five separate areas of contiguous space are to be allocated to the data 
set and each area must be equal to or greater than the primary quantity. This 
subparameter affects only primary space allocation. 

Note: Do not code an ALX subparameter for an indexed sequential data set. 

ROUND 

When the first subparameter specifies the average block length, requests that space 
allocated to the data set must be equal to an integral number of cyhnders. If the first 
subparameter specifies TRK or CYL, the system ignores ROUND. 



Request for Specific Tracks 



ABSTR 

Requests that the data set be allocated at the specified location on the volume. 

primary-qty 

Specifies the number of tracks to be allocated to the data set. 

The volume must have enough available space for the primary quantity. If it does not, 
the system terminates the job step. 

address 

Specifies the track number of the first track to be allocated. Count the first track of the 
first cylinder on the volume as 0. Count through the tracks on each cyUnder until you 
reach the track on which you want the data set to start. 

Note: Do not request track 0. 

directory 

Specifies the number of 256-byte records needed in the directory of a partitioned data set. 

Note: When creating a partitioned data set, you must request space for a directory. 

index 

Specifies the number of tracks needed for the index of an indexed sequential data set. 
The number of tracks must equal one or more cylinders. 
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Relationship to Otiier Parameters 

Do not code the following parameters with the SPACE parameter. 



* 


DLM 


QNAME 


AMP 


DYNAM 


SYSOUT 


DATA 


OUTLIM 




DDNAME 


OUTPUT 





With DCB KEYLEN for Block Requests: If space is requested in blocks and the blocks have 
keys, code the DCB subparameter KEYLEN on the DD statement and specify the key length. 

SPACE for New Data Sets on Mass Storage Volumes 

• The SPACE parameter must be coded for new data sets on mass storage volumes when 
VOLUME = SER is coded. It is optional when MSVGP is coded. If you code neither 
VOLUME = SER nor MSVGP, SPACE must be coded even if you code 
VOLUME = PRIVATE. 

• Contiguous space is the MSVGP default. If you want a noncontiguous primary space 
allocation, you must specify the SPACE parameter. 

Examples of the SPACE Parameter 



//DDl DD DSNAME=&&TEMP,UNIT=MIXED,SPACE=(CYL,10) 

The DD statement defines a temporary data set. The UNIT parameter requests any available 
tape or direct access volume; MIXED is the installation's name for a group of tape and direct 
access devices. If a tape volume is assigned, the SPACE parameter is ignored; if a direct access 
volume is assigned, the SPACE parameter is used to allocate space to the data set. The SPACE 
parameter specifies only the required subparameters: the type of allocation and a primary 
quantity. It requests that the system allocate 10 cylinders. 

//DD2 DD DSNAME=PDS12,DISP=( ,KEEP) ,UNIT=3350, 

// VOLUME=SER=25143,SPACE=(CYL, (10, ,10) , ,CONTIG) 

The DD statement defines a new partitioned data set. The system allocates 10 cylinders to the 
data set, of which ten 256-byte records are for a directory. Since the CONTIG subparameter is 
coded, the system allocates 10 contiguous cylinders on the volume. 

//REQUESTl DD DSNAME=EXM,DISP=NEW,UNIT=3330 , VOLUME=SER=606674 , 
// SPACE=(1024,75) ,DCB=KEYLEN=8 

This DD statement requests space in block lengths. The average block length of the data is 
1024 bytes. 75 blocks of data are expected as output. Each block is preceded by a key eight 
bytes long. The system computes how many tracks are needed, depending on the device 
requested in the UNIT parameter. 
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//REQUEST2 DD DSNAME=PET,DISP=NEW,UNIT=3330 , VOLUME=SER=606674 , 
// SPACE= ( ABSTR ,(1,1)), DCB=KEYLEN=8 

In this example, the SPACE parameter asks the system to allocate one track, beginning on the 
second track of the volume. 

//DD3 DD DSNAME=MULTIVOL,UNIT=3350,DISP=( ,CATLG) , 

// VOLUME=SER=(223344, 223345) , SPACE= ( CYL , 554 , 554 ) 

This example shows how to create a multivolume data set on two complete volumes. The two 
volumes do not contain other data sets. A volume on 3350 Direct Access Storage contains 555 
cylinders. The unrequested cylinder contains the volume table of contents (VTOC). 
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SUBSYS Parameter 



Parameter Type: Keyword, optional 

Purpose: Use the SUBSYS parameter to request a subsystem to process this data set and, 
optionally, to specify parameters defined by the subsystem. 

In a loosely-coupled multiprocessing environment, the requested subsystem must be defined on 
all processors that could interpret this DD statement. 

References: For more information on the SUBSYS parameter and subsystem-defined 
parameters, refer to the documentation for the requested subsystem. 

Syntax: 



SUBSYS= 



subsystem-name 

( subsystem-name [ ,subsystem-subparameter] . . . ) 



Single Subparameter: You can omit the parentheses if you code only the subsystem-name. 

Number of Subparameters: Code up to 254 subsystem-subparameters, if needed. 

Multiple Subparameters: When the parameter contains more than the subsystem-name, 
separate the subparameters by commas and enclose the subparameter list in parentheses. 
For example, SUBSYS = PCYZ, 1 724,DT25). 

Positional Subparameters: If you omit a subparameter that the subsystem considers 
positional, code a comma in its place. 

Special Characters: When a subparameter contains special characters, enclose the 
subparameter in apostrophes. For example, SUBSYS = (XYZ, 1 724,'KEY = Y'). 

Code each apostrophe that is part of a subparameter as two consecutive apostrophes. For 
example, code O'Day as SUBSYS = {XYX,1724,'NAME = 0"D A Y'). 

Continuation onto Another Statement: Enclose the subparameter Ust in only one set of 
parentheses. End each statement with a comma after a complete subparameter. For 
example: 

//DSl DD DSNAME=DATA1, SUBSYS=( XYZ, 1724, •KEY=Y' , 
// DT25, ■NAME=0' 'DAY' ) 



Subparameter Definition 



subsystem-name 

Identifies the subsystem. The subsystem name is 1 through 4 alphanumeric or national 
characters; the first character must be alphabetic or national. The subsystem must be 
available in the installation. 
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subsystem-subparameter 

Specifies information needed by the subsystem. A subparameter consists of alphanumeric, 
national, or special characters. 

Relationship to Other Parameters 

Do not code the following DD parameters with the SUBSYS parameter. 



* 


DYNAM 


DATA 


OUTPUT 


DDNAME 


QNAME 


DLM 


SYSOUT 



The specified subsystem can define other parameters that must not be coded with the SUBSYS 
parameter. 

Ignored but Permitted DD Parameters: If the following DD parameters are specified, they are 
checked for syntax and ignored: 



COPIES 


OUTLIM 


DEST 


SPACE 


FCB 


UNIT 



DISP Parameter: The system checks the DISP status subparameter for syntax, but always 
indicates a status of MOD to the subsystem. If the DISP normal or abnormal termination 
subparameter is CATLG or UNCATLG, the system allocates the appropriate catalog to the 
subsystem. 

DUMMY Parameter: If DUMMY is specified with SUBSYS, the subsystem checks the syntax 
of the subsystem subparameters. If they are acceptable, the system treats the data set as a 
dummy data set. 

When This Statement Overrides a Procedure Statement: If SUBSYS appears on a DD 
statement that overrides a DD statement in a cataloged or in-stream procedure, the following 
occurs: 

• The system ignores a UNIT parameter, if specified, on the overridden DD statement. 

• The system nullifies a DUMMY parameter, if specified, on the overridden DD statement. 

Examples of the SUBSYS Parameter 



//DDl DD DSNAME=ANYDS,DISP=OLD,SUBSYS=ABC 

The DD statement asks subsystem ABC to process data set ANYDS. 

//DDl DD DSNAME=ANYDS,DISP=0LD,SUBSYS=(XYZ2, 
// 'KEYWORD=DATA VALUEl' ) 

The DD statement asks subsystem XYZ2 to process data set ANYDS. The system passes the 
subparameter KEYWORD = DATA VALUEl to the subsystem. The parameter is enclosed in 
apostrophes because it contains an equal sign and a blank, which are special characters. 
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//DDl DD DSNAME=ANYDS,DISP=OLD,SUBSYS=(XYZ2,IKJ2, 
// 'NAME=' • MODULE 1' ' ' , ' DATE=4/ll/86 ' ) 

The DD statement asks subsystem XYZ2 to process the data set ANYDS. The system passes 
three subparameters to the subsystem: IKJ2, NAME = 'MODULE 1' and DATE = 4/1 1/86. 
Note that the character string MODULE 1 is passed to the subsystem enclosed in apostrophes. 
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SYSOUT Parameter 



Parameter Type; Keyword, optional 

Purpose: Use the SYSOUT parameter to identify this data set as a system output data set, 
usually called a sysout data set. The SYSOUT parameter also: 

• Assigns this sysout data set to an output class. The attributes of each output class are 
defined during JES initialization; the attributes include the device or devices for the output 

class. 

• Optionally requests an external writer to process the sysout data set rather than JES. An 
external writer is an IBM- or installation-written program. 

• Optionally identifies the forms on which the data set is to be printed or punched. 

• Optionally refers to a JES2 /*OUTPUT statement for processing parameters. 

The sysout data set is processed according to the following processing options, in override 
order: 

• The options specified on this sysout DD statement. 

• The options specified on a referenced OUTPUT JCL statement. 

• The options specified on a referenced JES2 /*OUTPUT statement or on a JES3 
//*FORMAT statement. 

• The installation default options for the requested output class. 

Note: If a sysout data set has the same class as the JOB statement MSGCLASS parameter, the 
job log appears on the same output listing as this sysout data set. 

Output Classes: The installation should maintain a list of available output classes and their 
attributes. Some classes should be used for most printing and punching, but others should be 
reserved for special processing. Each class is processed by an output writer. The system 
operator starts the output writers for the commonly used output classes. If you plan to specify 
a special output class, ask the operator to start the output writer for that class. If the writer is 
not started before the job produces the sysout data set, the data set is retained until the writer is 
started. 

References: For information on output writers and external writers, see SPL: System 
Modifications. 
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Syntax: 



SYSOUT= 



'class 
[class] 



SYSOUT= ( , ) 



, writer-name 
, INTRDR 



, form-name 
f code-name 



You can omit the parentheses if you code only a class. 

All of the subparameters are positional. Code a comma to indicate an omitted 
subparameter as follows: 

— If you omit the class, code a comma to indicate the omission. For example, when 
other subparameters follow, code SYSOUT = (,XWTR,FM26). When other 
subparameters do not follow, code a null class as SYSOUT = (,). 

— If you omit a writer-name but code a form-name or code-name, code a comma to 
indicate the omission. For example, SYSOUT = (A„FM26). 

— Omission of the third subparameter does not require a comma. For example, 
SYSOUT = A or SYSOUT = (A,XWTR). 



Subparameter Definition 
class 



G) 



Identifies the output class for the data set. class is one character: A through Z or 
through 9. The attributes of each output class are defined during JES initialization; 
specify the class with the desired attributes. 



Requests the output class in the MSGCLASS parameter on the JOB statement. 



Specifies a null class. A null class must be coded to use the CLASS parameter on a 
referenced OUTPUT .TCL statement. 



writer-name 

Identifies an external writer. The name is 1 through 8 alphanumeric characters. 

Do not code STDWTR as a writer-name. STDWTR is reserved for JES and used as a 
parameter in the MVS operator's MODIFY command. 

INTRDR 

Tells JES that this sysout data set is to be sent to the internal reader as an input job 
stream. 
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Defaults 



Overrides 



form-name 

Identifies the print or punch forms, form-name is 1 through 4 alphanumeric or national 
characters. 

code-name 

Identifies an earUer JES2 /*OUTPUT statement from which JES2 is to obtain processing 
characteristics. The code-name must be the same as the code parameter on the JES2 
/♦OUTPUT statement. 

Note: 

• code-name is supported only on JES2 systems. 

• Do not specify the code-name subparameter when the job or job step contains an 
OUTPUT JCL statement. 



In a JES2 system, if you do not specify a class on this DD statement or a referenced OUTPUT 
JCL statement, JES2 assigns the sysout data set to output class A. 

If you do not code a writer-name subparameter on this DD statement or a referenced 
OUTPUT JCL statement, the installation's job entry subsystem processes the sysout data set. 

If you do not code a form-name subparameter on this DD statement or a referenced OUTPUT 
JCL statement, JES uses an installation default specified at initialization. 



The class subparameter of the DD statement SYSOUT parameter overrides an OUTPUT JCL 
CLASS parameter. On the DD statement, you must code a null class in order to use the 
OUTPUT JCL CLASS parameter; for example: 

//OUTDS DD SYSOUT=( J ,0UTPUT=*.0UT1 

The writer-name subparameter of the DD statement SYSOUT parameter overrides an 
OUTPUT JCL WRITER parameter. 

The form-name subparameter of the DD statement SYSOUT parameter overrides an OUTPUT 
JCL FORMS parameter. Note that the SYSOUT form-name subparameter can be only four 
characters maximum while both the OUTPUT JCL FORMS form-name and the JES 
initialization default form names can be eight characters maximum. 



Relationship to Other Parameters 



Do not code the following DD parameters with the SYSOUT parameter. 



* 


DDNME 


MSVGP 


ACCODE 


DISP 


PROTECT 


AMP 


DLM 


QNAME 


CHKPT 


DSNAME 


SUBSYS 


CNTL 


DYNAM 


VOLUME 


DATA 


LABEL 
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Ignored Parameters: Because JES allocates sysout data sets, the UNIT and SPACE parameters 
are ignored, if coded on a sysout DD statement. 

Parameters on Procedure DD Statements that are Overridden: When an overriding DD 
statement contains a SYSOUT parameter, the system ignores a UNIT parameter on the 
overridden DD statement in the cataloged or in-stream procedure. 

If the overridden DD statement contains a DSNAME parameter, the system issues a JCL 
warning message. 

SYSOUT and DEST Subparameters: Do not code the SYSOUT w^riter-name subparameter 
when coding a DEST userid subparameter. These subparameters are mutually exclusive. You 
can code: 

//VALIDl DD SYSOUT=D,DEST=( node, user id) 
//VALID2 DD SYSOUT=(D, writer-name) ,DEST=(node) 

With DCB Subparameters: JES2 ignores DCB = PRTSP = 2 on a DD statement that also 
contains a SYSOUT parameter. 

INTRDR with OUTPUT Parameter: Do not code an OUTPUT parameter when the 
writer-name subparameter is INTRDR. 

Relationship to Other Control Statements 

A sysout DD statement can directly or indirectly reference an OUTPUT JCL statement. The 
parameters on the referenced OUTPUT JCL statement combine with the parameters on the 
sysout DD statement to control the processing of the sysout data set. See "OUTPUT 
Parameter" on page 10-112 and Chapter 17, "OUTPUT JCL Statement." 

SYSOUT cannot specify a code-name subparameter in a job or job step that contains an 
OUTPUT JCL statement; in this case, JES2 treats the third subparameter as a form-name, 
instead of a reference to a JES2 /* OUTPUT statement. 

Backward References: Do not refer to a earlier DD statement that contains a SYSOUT 
parameter. 

Starting an External Writer when Requested 

When a statement supplying processing options for a sysout data set specifies an external writer, 
the writer must be started before it can print or punch the data set. The writer is started by a 
system command from the operator or in the input stream. If the writer is not started before 
the job produces the sysout data set, the data set is retained until the writer is started. 

Held Classes in a JES2 System 

The following topics describe held classes for different releases of JES2. 
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JES2 1.3.4 (or Earlier) 



For installations running a JES2 1.3.4 or earlier component: If SYSOUT specifies a class that is 
defined to JES2 as a held class, the sysout data set is held only if the JOB MSGCLASS 
parameter specifies (1) the same class as the SYSOUT parameter or (2) another class that is 
also defined to JES2 as a held class. 



JES2 1.3.6 or 2.1.5 (or Later) 



For installations running a JES2 1.3.6 or 2.1.5 component or a subsequent JES2 component: An 

installation option at JES2 initialization determines if both the class for the sysout data set and 
the class for the job's messages must be held in order for a sysout data set to be held. 

A sysout data set is held in the following cases: 

• The sysout DD statement contains HOLD = YES. 

• The sysout DD statement does not contain a HOLD parameter or contains HOLD == NO 
but requests a class that the installation defined as held and defined as: 

— Not requiring the message class to be a held class in order for the sysout data set to be 
held. The JOB statement MSGCLASS parameter can specify any class. 

— Requiring the message class to be a held class in order for the sysout data set to be 
held. The JOB MSGCLASS parameter must also specify a held class. 

A sysout data set is not held in the following cases: 

• The sysout DD statement does not contain a HOLD parameter or contains HOLD = NO 
and requests: 

— A class that the installation defined as not held. 

— A class that the installation defined as held and defined as requiring the message class 
to be a held class in order for the sysout data set to be held. The JOB MSGCLASS 
parameter must specify a class that is not held. 

Contact the installation to find out if holding the sysout class depends on a held MSGCLASS 
class. 



Significance of Output Classes 



To print this sysout data set and the messages from your job on the same output listing, code 
one of the following: 

• The same output class in the DD SYSOUT parameter as in the JOB MSGCLASS 
parameter. 

• DD SYSOUT = * to default to the JOB MSGCLASS output class. 
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DD SYSOUT = (,) to default to one of the following: 

1 . The CLASS parameter in an explicitly or implicitly referenced OUTPUT JCL 
statement. In this case, the OUTPUT JCL CLASS parameter should specify the same 
output class as the JOB MSGCLASS parameter. 

2. The JOB MSGCLASS output class, if no OUTPUT JCL statement is referenced or if 
the referenced OUTPUT JCL statement contains CLASS = *. 



Examples of the SYSOUT Parameter 



//DDl DD SYSOUT=P 

In this example, the DD statement specifies that JES is to write the sysout data set to the device 
handling class P output. 

//JOB50 JOB ,'C. BROWN' ,MSGCLASS=C 
//STEPl EXEC PGM=SET 
//DDX DD SYSOUT=C 

In this example, DD statement DDX specifies that JES is to write the sysout data set to the 
device handling class C output. Because the SYSOUT parameter and the MSGCLASS 
parameter specify the same class, the messages from this job and the sysout data set can be 
written to the same device. 

//STEPl EXEC PGM=ANS 

//OTl OUTPUT DEST=NYC 

//0T2 OUTPUT DEST=LAX 

//0T3 OUTPUT C0PIES=5 

//DSA DD SYSOUT=H,OUTPUT=(*.OT2,*.OTl,*.OT3) 

In this example, the DD statement combines with the three referenced OUTPUT JCL 
statements to create three separate sets of output: 

1. DSA combines with OTl to send the sysout data set to NYC. 

2. DSA combines with 0T3 to send the sysout data set to LAX. 

3. DSA combines with 0T3 to print five copies of the data set locally on the printer used for 
output class H. 

Note that the output references can be in any order. 
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//DD5 DD S YSOUT= ( F , , 2PRT ) 

In this example, the DD statement specifies that JES is to write the sysout data set to the device 
handling class F output. The data set is to be printed or punched on forms named 2PRT. 

//J0B51 JOB ACCT123,MAEBIRD,MSGCLASS=B 

//STEPl EXEC PGM=RPTWTR 

//OUTl OUTPUT CLASS=* 

//REPORT DD SYSOUT= ( , ) , OUTPUT=* . OUTl 

In this example, JES processes the sysout data set defined in DD statement REPORT in output 
class B. Because SYSOUT specifies a null class, the CLASS parameter in the explicitly 
referenced OUTPUT JCL statement is used. That CLASS parameter specifies the MSGCLASS 
output class. 
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TERM Parameter 



Parameter Type: Keyword, optional 

Purpose: Use the TERM parameter to indicate to the system that a data set is coming from or 
going to a terminal for a TSO user. 

Syntax: 



TERM=TS 



Subparameter Definition 

TS 

In a foreground job submitted by a TSO user, indicates that the input or output data set is 
coming from or going to a TSO userid. 

In a background or batch job, the system either: 

• Treats the TERM = TS parameter as a SYSOUT = * parameter, when it appears by 
itself. 

• Ignores the TERM = TS parameter, when it appears with other parameters. 

Relationship to Other Parameters 

Do not code the following DD parameters with the TERM parameter. 



* 


DLM 


AMP 


DYNAM 


DATA 


PROTECT 


DDNAME 


QNAME 



Code only the DCB and SYSOUT parameters with the TERM parameter. The system ignores 
any other DD parameters. 



Location in the JCL 



In a foreground TSO job, a DD statement containing TERM = TS and a SYSOUT parameter 
begins an in-stream data set. 

In a batch job, a DD statement containing TERM = TS begins an in-stream data set. 

When concatenating DD statements, the DD statement that contains TERM = TS must be the 
last DD statement in a job step. 
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Examples of the TERM Parameter 



//DDl DD TER]y!=TS 

In a foreground job submitted from a TSO userid, this DD statement defines a data set coming 
from or going to the TSO userid. In a batch job, TERM = TS is treated as as though 
SYSOUT = * were coded. 

//DD3 DD UNIT=3400-5,DISP=(MOD,PASS) ,TERM=TS,LABEL=( ,NL) , 
// DCB=(LRECL=80,BLKSIZE=80) 

In a foreground job, the system ignores all of the parameters in this example except TERM and 
DCB. In a batch job, the system ignores only the TERM parameter. 



10- 1 38 MVS/XA JCL Reference 



DD: UCS 



UCS Parameter 



Parameter Type: Keyword, optional 
Purpose: Use the UCS parameter to identify: 

• The universal character set (UCS) image JES is to use in printing this sysout data set. 

• A print train (print chain or print band) JES is to use in printing this sysout data set on an 
impact printer. 

• A character-arrangement table for this sysout data set printed on 3800 Printing Subsystem 
in a JES2 system. In this use, the UCS parameter acts like a CHARS parameter. 

The UCS image specifies the special character set to be used. JES loads the image into the 
printer's buffer. The UCS image is stored in SYSI.IMAGELIB. IBM provides the special 
character set codes in Figure 10-2. 

References: For more information on the UCS parameter, see System-Data Administration. 

Syntax: 



ucs= 



character-set-code 
( character-set-code 



,FOLD 



[, VERIFY] 



• You can omit the parentheses if you code only a character-set-code. 

• All of the subparameters are positional. If you omit FOLD but code VERIFY, code a 
comma to indicate the omission. For example, UCS = (AN„VERIFY). 



Subparameter Definition 



character-set-code 

Identifies a universal character set. The character-set-code is 1 through 4 alphanumeric or 
national characters. See Figure 10-2 for IBM standard special character set codes. 

FOLD (JES2only) 

Requests that the chain or train for the universal character set be loaded in fold mode. 
Fold mode is described in IBM 2821 Control Unit Component Description. Fold mode is 
most often used when upper- and lower-case data is to be printed only in uppercase. 

Note: FOLD is supported only on JES2 systems. 

VERIFY 

Requests that, before the data set is printed, the operator verify visually that the character 
set image is for the correct chain or train. The character set image is displayed on the 
printer before the data set is printed. 
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Defaults 



Overrides 



1403 


3203 
Model 5 


3211 


Characteristics 


AN 


AN 


All 


Arrangement A, standard EBCDIC character set, 48 characters 


HN 


HN 


Hll 


Arrangement H, EBCDIC character set for FORTRAN and COBOL, 48 characters 






Gil 


ASCII character set 


PCAN 


PCAN 




Preferred alphanumeric character set, arrangement A 


PCHN 


PCHN 




Preferred alphanumeric character set, arrangement H 


PN 


PN 


Pll 


PL/I alphanumeric character set 


QN 


QN 




PL/I preferred alphanumeric character set for scientific applications 


QNC 


QNC 




PL/1 preferred alphanumeric character set for commercial applications 


RN 


RN 




Preferred character set for commercial applications of FORTRAN and COBOL 


SN 


SN 




Preferred character set for text printing 


TN 


TN 


Til 


Character set for text printing, 120 characters 


XN 






High-speed alphanumeric character set for 1403, Model 2 


YN 






High-speed preferred alphanumeric character set for 1403, Model Nl 


Note: Where three v 
selects the set corres] 


alues exi 
)onding 1 


St (for the 1403, 3211, and 3203 Model 5 printers), code any one of them. JES 
Lo the device on which the data set is printed. 


Not all of these char 
character sets to mee 
for using character s 


acter sets may be available at your installation. Also, an installation can design 
t special needs and assign a unique code to them. Follow installation procedures 
;ts. 



Figure 10-2. Special Character Sets for the 1403, 3203 Model 5, and 3211 Printers 



If you do not code the UCS parameter, the system checks the UCS image in the printer's 
buffer; if it is a default image, as indicated by its first byte, JES uses it. If it is not a default 
image, JES loads the UCS image that is the installation default specified at JES initialization. 

On an impact printer, if the chain or train does not contain a valid character set, JES asks the 
operator to specify a character set and to mount the corresponding chain or train. 



For printing on a printer with the UCS feature, the UCS parameter on a sysout DD statement 
overrides an OUTPUT JCL UCS parameter. For printing on a 3800, a CHARS parameter on 
the sysout DD statement or the OUTPUT JCL statement overrides all UCS parameters. 

For a data set scheduled to the Print Services Facihty (PSF), the PSF uses the following 
parameters, in override order, to select the font list: 

1. Font list in the Ubrary member specified by an OUTPUT JCL PAGEDEF parameter. 

2. DD CHARS parameter. 

3. OUTPUT JCL CHARS parameter. 

4. DD UCS parameter. 

5. OUTPUT JCL UCS parameter. 
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6. JES installation default for the device. 

7. Font list on the PAGEDEF parameter in the PSF cataloged procedure. 
See "PAGEDEF Parameter" on page 17-48 for more information. 



Relationship to Other Parameters 



Do not code the following DD parameters with the UCS parameter. 



* DLM 

AMP DYNAM 

DATA PROTECT 

DDNAME QNAME 



Do not code the UCS parameter with the DCB subparameters RKP and CYLOFL. 

Do not code the FOLD and VERIFY subparameters on the same statement with a SYSOUT 
parameter; the system ignores FOLD and VERIFY for a sysout data set. 



Using Special Character Sets 



To use a special character set, SYSl.IMAGELIB must contain an image of the character set, 
and the chain or train for the character set must be available. IBM provides standard special 
character sets, and the installation may provide user-designed special character sets. 



Examples of the UCS Parameter 



//DDl DD UNIT=1403,UCS=(YN, , VERIFY) 

In this example, the DD statement requests a 1403 Printer. The UCS parameter requests the 
chain or train for special character set code YN. Because VERIFY is coded, the system will 
display the character set image on the printer before the data set is printed. 

//DD2 DD SYSOUT=G,UCS=PN 

In this example, the DD statement requests the device for output class G. If the device is a 
printer with the UCS feature, the system loads the UCS image for code PN. If the device is an 
impact printer, the system asks the operator to mount the chain or train for PN, if it is not 
already mounted. If the device is a 3800, the system uses the UCS subparameter to select the 
character-arrangement table. Otherwise, the system ignores the UCS parameter. 
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UNIT Parameter 



Parameter Type: Keyword, optional 

Purpose: Use the UNIT parameter to ask the system to place the data set on: 

• A specific device. 

• A certain type or group of devices. 

• The same device as another data set. 

The UNIT parameter can also tell the system how many devices to assign and request that the 
operator should defer mounting the volume until the data set is opened. 

Syntax: 



UNIT= I 



device-number 
device-type 
group -name 



, unit-count 



[, DEFER] 



UNIT=AFF=ddname 



You can omit the parentheses if you code only the first subparameter. 

All of the subparameters are positional. If you omit unit-count or P but code DEFER, 
code a comma to indicate the omission; one device is assigned to the data set. For 
example, UNIT = (3420„DEFER). 



Subparameter Definition 



device-number 

Identifies a particular device, device-number is the 3-character hexadecimal number for 
the device. 

Warning: Do not identify a device by its number unless absolutely necessary. Specifying a 
device number limits device assignment; it will delay a job if another job is using the 
device. 

In a JESS system, if any DD UNIT parameter in a job specifies a device-number for a 
device that is JES3 -managed or jointly JES3/MVS managed, the JES3 //*MAIN statement 
must contain a SYSTEM parameter. 

However, for a permanently mounted direct access device, such as a 3350 Direct Access 
Storage, specifying UNIT = 3350 and a volume serial number in the VOLUME = SER 
parameter has the same result as specifying a device number in the UNIT parameter. 

device-type 

Requests a device by its generic name, which is an IBM-suppUed name that identifies a 
device tjy its machine type and model. For example, UNIT = 3350. 

When a device-type name contains a hyphen, do not enclose it in apostrophes, for 
example, UNIT = 3400-5. 
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IBM device types are listed in Installation: System Generation. Obtain a list of device 
types from your installation. 

Rules for Certain Devices: 

• For a 3330 Disk Storage Model 1 1 , code UNIT = 3330- 1 . 

• If your installation has 3340 Direct Access Storage Facilities both with and without 
the Fixed Head feature, do not code the device type in the UNIT parameter. Instead, 
code the device number or a group-name. 

• For a 3480 Magnetic Tape Subsystem in compatibility mode, code UNIT = 3400-9 or 
a group-name. 

• For mass storage volumes, code UNIT = 3330V. 

group-name 

Requests a group of devices by a symbolic name. The installation must have assigned the 
name to the device(s) during system generation or IBM must have assigned the name. 
The group-name is 1 through 8 alphanumeric characters. 

Group Names: A group-name can identify a single device or a group of devices. A group 
can consist of devices of the same or different types. For example, a group can contain 
both direct access and tape devices. 

Allocation from Groups: The system assigns any available device from the group. If a 
group consists of only one device, the system assigns that device. If the group consists of 
more than one device type, the units requested are allocated from the same device type. 
For example, if GPDA contains 3330 Disk Storage and 3350 Direct Access Storage 
devices, a request for two units would be allocated to two 3330s or to two 3350s. 

Extending Data Set: If a data set that was created using the group-name subparameter is 
to be extended, the system allocates additional devices of the same type as the original 
devices. However, the additional devices may not necessarily be from the same group. 

SYSALLDA: IBM assigned group-names include SYSALLDA, which contains all direct 
access devices defined to the system. 

unit-count 

Specifies the number of devices for the data set. The unit-count is a decimal number from 
1 through 59. 

Number of Devices Allocated: The system uses the unit-count to determine how many 
devices to allocate. However, if the UNIT parameter also specifies P, for parallel mount, 
the system uses the greatest of the following numbers to determine how many devices and 
volumes to allocate: 

• unit-count 

• volume-count specified in the VOLUME parameter 

• number of serial numbers implicitly or explicitly specified 

You may also receive more devices than the unit-count requests if you specify 
VOLUME = REF or a permanently resident or reserved volume. Also, if two DD 
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statements in a step request the same volume and either DD statement requests any other 
volume(s), the system assigns an additional device. 

Unit Count for Received or VOLUME = REF Data Sets: The system assigns one device 
when the DD statement receives a passed data set or refers in a VOLUME = REF 
subparameter to a cataloged data set or earlier DD statement for volume and unit 
information. Code a unit-count subparameter if the data set needs more than one device. 

Unit Count for Mass Storage Volumes: For mass storage volumes, specify a unit-count 
that is less than the volume-count in order to extend a muthvolume data set to a 
non-mounted volume. If an old multivolume data set resides on a group of mass storage 
volumes, specify a unit-count equal to the number of volumes for the data set or specify P 
for parallel mount; otherwise, in a JES3 environment, the last volume containing the data 
set is left mounted exclusive to the operating system. 

Unit Count when Device Number Specified: When the first subparameter requests a 
specific device, the unit count must be 1 or omitted. A unit count greater than 1 is an 
error. 



Asks the system to allocate the same number of devices as requested in the VOLUME 
volume-count or SER subparameter, whichever is higher. Thus, all volumes for the data 
set are mounted in parallel. 

DEFER 

Asks the system to assign the data set to device(s) but requests that the volume(s) not be 
mounted until the data set is opened. To defer mounting, DEFER must be specified or 
implied for all DD statements that reference the volume. 

DEFER wlien Data Set is Never Opened: If you request deferred mounting of a volume 
and the data set on that volume is never opened by the processing program, the volume is 
never mounted during the job step. 

Restrictions on DEFER: Do not code DEFER: 

• For a new data set on direct access. The system ignores DEFER. 

• On a SYSCKEOV DD statement. 

• For volumes of a mass storage volume group (MSVGP) when the step contains new 
data set requests for the same mass storage volume group. The delay can cause 
volume conflicts within the job or between jobs and so cause poor performance. 

AFF = ddname 

Requests that the system allocate different data sets residing on different, removable 
volumes to the same device during execution of the step. This request is called unit 
affinity. The ddname is the ddname of an earlier DD statement in the same step. 

Use unit affinity to reduce the number of devices used in a job step: request that an 
existing data set be assigned to the same device(s) as another existing data set. 



1 0- 1 44 M VS/XA JCL Reference 



DD: UNIT 



Restrictions on UNIT = AFF: Do not code UNIT = AFF with the following: 

• DISP = NEW if the data set referenced in the AFF subparameter is on direct access. 

• DD * or DD DATA. 

• FREE = CLOSE in the DD statement referenced in the AFF subparameter. 

Overrides 

If you code SYSOUT and UNIT on the same statement, the SYSOUT parameter overrides the 
UNIT parameter. 

The system also obtains device information when the system obtains volume serial information 
from: 

• A VOLUME = REF = dsname reference to an earlier data set. 

• A VOLUME = REF = ddname reference to an earlier DD statement. 

• The volume(s) for a passed data set. 

• The catalog for a cataloged data set. 

However, you can override the retrieved device information if the device you specify is a subset 
of the retrieved device information. For example, if the retrieved unit grouping is 3350, and the 
specified unit subparameter is 3350A (a subset of 3350), then the system allocates from the 
devices contained in 3 3 50 A. 

Relationship to Other Parameters 

Do not code the following DD parameters with the UNIT parameter. 



* 


DLM 


DATA 


DYNAM 


DDNAME 


QNAME 



Do not code the UNIT DEFER subparameter on a SYSCKEOV DD statement. 

UNIT = AFF and Other Parameters: Do not code DISP = NEW with UNIT == AFF = ddname if 
the referenced data set for DD statement ddname resides on a direct access device. If coded, 
the system terminates the job. If the referenced data set can be allocated to either tape or direct 
access devices, the system allocates both requests to tape devices. 

Do not code UNIT = AFF on a DD * or DD DATA statement or on a DD statement 
containing a SUBSYS parameter. The system ignores UNIT == AFF and defaults the device to 

o I ij/\JL/l_(JL'/V. 

Do not code UNIT = AFF = ddname when DD statement ddname contains FREE = CLOSE. 
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Location in tlie JCL 

When a DD statement contains a UNIT = AFF = ddname parameter, the DD statement 
referenced in the AFF subparameter must be earlier in the job step; otherwise, the system 
treats the DD statement containing UNIT = AFF as a DD DUMMY statement. For example, 
code: 

//STEP EXEC PGM=TKM 

//DDl DD DDNAME=DD5 

//DD2 DD DSNAME=A,DISP=OLD 

//DD3 DD DSNAME=C,DISP=SHR,UNIT=AFF=DD1 

//DD5 DD DSNAME=B,DISP=SHR 

Examples of the UNIT Parameter 



//STEP2 EXEC PGM=POINT 

//DDX DD DSNAME=EST, DISP=MOD,VOLUME=SER=( 42569, 42570 ) , 

// UNIT={3330,2) 

//DDY DD DSNAME=ERAS,DISP=OLD,UNIT=3330-1 

//DDZ DD DSNAME=RECK,DISP=OLD, 

// VOLUME=SER=( 40653, 13262) ,UNIT=AFF=DDX 

DD statement DDX requests two 3330 Disk Storage devices, DD statement DDZ requests the 
same two devices as DDX. Note that the operator will have to change volumes on the two 
3330 devices during execution of the job step. 

DD statement DDY requests one 3330 Disk Storage Model 11. 

//DDl DD DSNAME=AAG3,DISP=(,KEEP) , 
// VOLUME=SER=13230,UNIT=3400-5 

This DD statement defines a new data set and requests that the system assign any 3420 
Magnetic Tape Unit that can operate in 6250 BPI NRZI nine-track format. 

//DD2 DD DSNAME=X-Y.Z,DISP=0LD,UNIT=(,2) 

This DD statement defines a cataloged data set and requests that the system assign two devices 
to the data set. The system obtains the device type from the catalog. 

//DD3 DD DSNAME=COLLECT,DISP=OLD, 

// VOLUME=SER=1095,UNIT=(3330, , DEFER) 

This DD statement defines an existing data set that resides on a direct access volume and 
requests that the system assign a 3330 Disk Storage. Because DEFER is coded, the volume will 
not be mounted until the data set is opened. 

//STEPA DD DSNAME=FALL,DISP=OLD,UNIT=237 

For this data set, the system retrieves the volume and device type from the catalog. The UNIT 
parameter, by specifying device 237, overrides the catalog device type; however, device 237 
must be the same type as the device stated in the catalog. 
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VOLUME Parameter 



Parameter Type: Keyword, optional 

Purpose: Use the VOLUME parameter to identify the volume or volumes on which a data set 
resides or will reside. You can request: 

• A private volume 

• Retention of the volume 

• A specific volume by serial number 

• The same volume that another data set uses 



You can also specify which volume of a multivolume data set is to be processed first and, for 
an output data set, the number of volumes required. 

A nonspecific volume request is a DD statement for a new data set that can be assigned to any 
volume or volumes. To make a nonspecific volume request for a new data set, either: 

• Omit the VOLUME parameter. 

• Code a VOLUME parameter but omit a SER or REF subparameter. 

Syntax: 



VOLUME 
VOL 



PRIVATE 



, RETAIN 



, volume- sequence-number 



[ , volume-count] 



[J 



SER=serial-number 

SER= ( serial-number [ , serial-number] . . . ) 

REF=dsname 

REF=* .ddname 

REF=* . stepname.ddname . 

REF=* . stepname .procstepname . ddname / 



Single Subparameter: You can omit the parentheses if you code only PRIVATE or only a keyword 
subparameter. For example, VOLUME = PRIVATE or VOLUME = SER = 222001 or 
VOLUME = REF = DSL 

Positional Subparameters: The first four subparameters are positional. The last subparameter, SER or 
REF, is a keyword subparameter and must follow all positional subparameters. Code a comma to indicate 
an omitted positional subparameter as follows: 

• If you omit PRIVATE and another positional subparameter follows, code a comma in its place. For 
example, VOLUME = (,RETAIN,2,3,SER = (222001,222002,222003)). 

• Code a comma when RETAIN is omitted and the volume sequence number or the volume count 
subparameter follows. For example, VOLUME = (PRIVATE„2,3,SER = (222001,222002,222003)). 

• Code a comma when the volume sequence number is omitted and the volume count subparameter 
follows. For example, VOLUME = (,RETAIN„3,SER = (222001,222002,222003)) and 
VOLUME = (PRIVATE,„3,SER = (22200 1 ,222002,222003)) and 

VOLUME = („„3,SER = (222001,222002,222003)). 
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• Code a comma when the volume count is omitted, at least one other subparameter precedes it, and a 
keyword subparameter follows. For example, 
VOLUME = (RETAIN,2„SER = (222001 ,222002,222003)). 

Single SER Subparameter: You can omit the parentheses in the SER subparameter if you code only one 
serial number. For example, VOLUME = SER = 222001. 

Special Characters When a serial number in the SER subparameter contains special characters, other than 
hyphens, enclose it in apostrophes. For example, VOLUME = SER = (22200 1,222-02,'222/03'). 

When the dsname in the REF subparameter contains special characters, other than the periods used in a 
qualified name, enclose it in apostrophes. For example, VOLUME = REF = 'DS/284'. 

Code each apostrophe that is part of the serial number or data set name as two consecutive apostrophes. 
For example, VOLUME = SER = '0"HARE' or VOLUME = REF = 'DS"371'. 



Subparameter Definition 



PRIVATE 

Requests a private volume. Private means that: 

• The system is not to allocate an output data set to the volume unless the volume is 
specifically requested, such as in a VOLUME = SER subparameter. 

• If tape, the volume is to be demounted after the data set is closed, unless RETAIN is 
also coded or the DD DISP parameter specifies PASS. 

• If a demountable direct access volume, the volume is to be demounted after the data 
set is closed. 

RETAIN 

For a private tape volume, RETAIN requests that this volume is not to be demounted or 
rewound after the data set is closed or at the end of the step. For a public tape volume, 
RETAIN requests that this volume is to be retained at the device if it is demounted 
during the job. 

RETAIN Support: RETAIN is supported only for tape volumes managed by the basic 
control program and by JES2. If coded on a DD statement for a tape data set on a 
JES3-managed device, JES3 ignores the parameter when issuing KEEP/RETAIN 
messages and when perfoiming deallocation at the end of the job. However, if RETAIN 
is coded for a tape data set on a JES3 -managed device and the tape volume is to be 
shared with a later step, JES3 designates the volume as retained. 

RETAIN has no effect on the handling of direct access volumes. 

Deallocatioii Despite RETAIN: Coding RETAIN does not ensure that the operator will 
not unload the volume or that the system will not deallocate and demount it for another 
job. Either can occur when the device on which the volume is mounted is not allocated to 
the job step that specified RETAIN or, for unlabeled tapes, when the volume requires 
verification. 
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volume-sequence-number 

Identifies the volume of an existing multivolume data set to be used to begin processing 
the data set. The volume sequence number is a decimal number from 1 through 255; the 
first volume is identified as 1. The volume sequence number must be less than or equal to 
the number of volumes on which the data set exists; otherwise, the job fails. 

If the volume sequence number is not specified but DCB == dsname is coded on a DD 
statement, the volume sequence number is copied from the label for the cataloged data 
set. 

For new data sets, the system ignores the volume sequence number. 

volume-count 

Specifies the maximum number of volumes that an output data set requires. The volume 
count is a decimal number from 1 through 255. The total volume count for all DD 
statements in one job step cannot exceed 4095. 

Code a volume count when a new data set will reside on 6 or more volumes. If the 
volume count is omitted or if the specified count is 1 through 5, the maximum number 
allowed is 5; if the specified count is 6 through 20, the maximum number allowed is 20: if 
the specified count is greater than 20, the maximum number allowed is a multiple of 15 
plus 5, up to a maximum of 255. 

Unequal Volume Count and Serial Numbers: If the volume count is greater than the 
number of volume serials coded in the SER subparameter, the system assigns other 
volumes to the remaining devices. If the volume count is smaller than the nimiber of 
volume serials, the system ignores the volume count. 

If a data set may need more volumes than the number of volume serials coded, specify a 
volume count equal to the total number of volumes that might be used. Requesting more 
volumes in the volume count will make sure that the data set can be written on more 
volumes if it exceeds the requested volumes. 

Volume Count for Nonspecific Requests: If the request is for a nonspecific, public volume 
on a direct access device, the system ignores the volume count and allocates the number 
of volumes in the UNIT unit count subparameter. 

If the request is for a nonspecific, private volume, the system treats it like a specific 
request if the volume count is more than one and allocates the number of volumes in the 
volume count. 

For more information on determining the number of volumes per request, see SPL: 
System Modifications. 

SER = serial-number 

SER = (serial-number[,serial-number]...) 

Identifies by serial nimiber the volume(s) on which the data set resides or will reside. A 
volume serial number is 1 through 6 alphanumeric, national, or special characters; 
enclose a serial number that contains special characters, other than hyphens, in 
apostrophes. If the number is shorter than 6 characters, it is padded with trailing blanks. 

You can code a maximum of 255 volume serial numbers on a DD statement. 
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Do not specify duplicate volume serial numbers in a SER parameter. Each volume must 
have a unique volume serial number, regardless of whether it is a tape or disk volume. 

Do not code a volume serial number as SCRTCH, PRIVAT, or Lnnnnn (L with five 
numbers); these are used in messages to ask the operator to mount a volume. When using 
some typewriter heads or printer chains, a volume serial number may be unrecognizable if 
you code certain special characters. 

For a permanently mounted direct access device, such as a 3350 Direct Access Storage, 
specifying a volume serial number and UNIT = 3350 has the same result as specifying a 
device number in the UNIT parameter. 

REF = dsname 

REF = *.ddname 

REF = *.stepnaine.ddiianie 

REF = *.stepnaine.procstepname.ddname 

Tells the system to obtain volume serial numbers from another data set or an earlier DD 
statement. 

dsname 

Names a cataloged or passed data set. The system assigns this data set to the same 
volumes containing the cataloged or passed data set. The dsname cannot be a 
generation data group (GDG) name or a GDG member. 

When the dsname contains special characters, other than the periods used in a 
qualified name, enclose it in apostrophes. 

When dsname names a passed data set, it must appear on a DD statement before 
the receiving DD statement. (After a passed data set is received, the passed data set 
information is no longer available.) 

*.ddname 

Asks the system to obtain the volume serial numbers from earlier DD statement 
ddname in the same job step. 

* .stepname.ddname 

Asks the system to obtain the volume serial numbers from DD statement, ddname, 
in an earUer step, stepname, in the same job. 

"^.stepname.procstepname.ddname 

Asks the system to obtain the volume serial numbers from a DD statement in a 
cataloged or in-stream procedure. Stepname is the name of the job step that calls 
the procedure, procstepname is the name of the procedure step that contains the 
DD statement, and ddname is the name of the DD statement. 



Referenced Data Set Not Opened: When REF refers to a DD statement in a previous step 
and the data set was not opened, the system allocates a device that has the widest range 
of eligibiHty to meet both DD statement requests. Thus, the system might allocate a 
device for which the referring data set is not eUgible. To prevent this problem for tape 
data sets, always code the DCB DEN subparameter on a DD statement that you plan to 
reference. 
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References to Multivolume Tape Data Sets: When REF refers to a data set residing on 
more than one tape volume, the system allocates only the last volume. If this job step 
extends the data set to more volumes, this new volume information is not available to 
following DD statements. 

References to Multivolume Direct Access Data Sets: When REF refers to a data set that 
resides on more than one direct access volume, the system allocates all of the volumes. 

References to DD Statements with UNIT Group Names: When REF refers to a DD 
statement containing a UNIT group-name subparameter, the system allocates a device of 
the same type actually used for the referenced data set, but not necessarily a device in the 
referenced group-name. 

References to VSAM Data Sets: When REF refers to a multivolume VSAM data set, the 
system allocates a device of the same type as the first device type used for the referenced 
VSAM data set. 

Do Not Refer to In-Stream Data Sets: Do not refer to a DD *, DD DATA, or DD 
SYSOUT statement. The system ignores the reference and defaults the device name to 
SYSALLDA, which is the group name for all direct access devices defined to the system. 

References to DUMMY Data Sets: If ddname refers to a DD DUMMY statement, the 
data set for this DD statement is also assigned a dummy status. 

Label Type Picked up from Referenced Statement: When REF is coded, the system also 
copies the LABEL label type subparameter from the referenced DD statement. 

Overrides 

The volume sequence number overrides a DISP=MOD parameter. Thus, instead of starting at 
the end of the data set on the last volume, according to the MOD subparameter, processing of 
the data set begins with the volume indicated by the volume sequence number. 

Relationship to Other Parameters 

Do not code the following parameters with the VOLUME parameter. 



* 


DDNAME 


MODIFY 


QNAME 


BURST 


DLM 


MSVGP 


SYSOUT 


CHARS 


DYNAM 


OUTLIM 




COPIES 


FLASH 


OUTPUT 





Other DD Parameter Picked upfront Referenced Statement: When REF is coded, the system 
also copies the LABEL label type subparameter from the referenced DD statement. 

With Mass Storage Volumes For New Data Sets: 

• The SPACE parameter is required when VOLUME = SER is coded. 

• To guarantee allocation of a nonspecific request to SYSGROUP, specify 
VOLUME = PRIVATE or MSVGP = SYSGROUP. 
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For 3540 Diskette Input/ Output Units: The VOLUME = SER, DCB = BUFNO, and DSID 

parameters on a DD * or DD DATA statement are ignored except when they are detected by a 
diskette reader as a request for an associated data set. See IBM 3540 Programme/ s Reference. 

VOLUME Parameter in a JES3 System 

When you do not code a volume serial number, code PRIVATE if you want JES3 to manage 
the allocation. Otherwise, MVS manages the allocation. 

RETAIN is ignored in a JES3 system. 

VOLUME Parameter for Optical Readers 

For optical readers, if no volume serial number is specified, the system assumes 
VOLUME = SER = OCRINP. 

VOLUME Parameter for Nonspecific Volume Requests 

A nonspecific volume request can appear on a DD statement for a new data set; the data set is 
assigned to any volume or volumes. The nonspecific request is made through a VOLUME 
parameter that does not contain a SER or REF subparameter. The parameter can contain the 
following subparameters: 

VOLUME= ( PRIVATE , RETAIN , , volume-count ) 

Examples of the VOLUME Parameter 



//DDl DD DSNAME=DATA3,UNIT=3340,DISP=OLD, 
// VOLUME=( PRIVATE, SER=548863) 

The DD statement requests an existing data set, which resides on the direct access volume, 
serial number 548863. Since PRIVATE is coded, the system will not assign to the volume 
another data set for which a nonspecific volume request is made and will demount the volume 
at the end of the job. 

//DD2 DD DSNAME=QUET, DISP=( MOD, KEEP ) ,UNIT=( 3400-5,2 ) , 
// VOLUME= ( , , , , 4 , SER= ( 96341 , 96342 ) ) 

The DD statement requests an existing data set, which resides on two volumes, serial numbers 
96341 and 96342. The VOLUME volume count subparameter requests four volumes, if 
required. Thus, if more space is required, the system can assign a third and fourth volume. 

//DD3 DD DSNAME=QOUT,UNIT=3400-5 

The DD statement defines a data set that is created and deleted in the job step. By omission of 
the VOLUME parameter, the statement makes a nonspecific volume request, thereby asking the 
system to assign a suitable volume to the data set. 



10-152 M VS/XA JCL Reference 



DD: VOLUME 



//DD4 DD DSNAME=NEWDASD,DISP=( ,CATLG,DELETE) ,UNIT=3350, 
// V0LUME=SER=3 35006, SPACE=(CYL, (10,5)) 

This new data set is assigned to volume serial number 335006, which is a permanently mounted 
volume on a particular 3350 Direct Access Storage. You can obtain the same space on the 
same volume in another way: Instead of specifying the volume serial number and UNIT = 3350, 
you can specify the device number of the particular 3350 device in the UNIT parameter. 

//OUTDD DD DSNAME=TEST.TWO,DISP=(NEW,CATLG) , 

// VOLUME=( , , , ,3, SER=(333001, 333002, 333003) ) , 

// SPACE=(TRK, (9,10) ) ,UNIT=( 3330 ,P) 

//NEXT DD DSNAME=TEST. TWO, DISP= (OLD, DELETE) 

DD statement OUTDD creates a multivolume data set and catalogs it. If the data set does not 
require three volumes, it will reside on fewer volumes. DD statement NEXT then deletes the 
data set. 

If the data set resides on fewer volumes than the number of volumes on which it is cataloged, 
the following messages appear in the job log when the system deletes the data set: 

IEF285I TEST. TWO DELETED 

IEF285I VOL SER NOS=333001 , 333003 . 

IEF283I TEST. TWO NOT DELETED 8 

IEF283I VOL SER NOS=333002 1. 

IEF283I TEST. TWO UNCATALOGED 

IEF283I VOL SER NOS=333001, 333002, 333003 . 

If the data set resides on all specified volumes, the following messages appear in the job log 
when the system deletes the data set: 

IEF285I TEST. TWO DELETED 

IEF285I VOL SER NOS=333001, 333002 , 333003 . 
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Chapter 11. Special DD Statements 



Use special DD statements to specify private catalogs, private libraries, and data sets for 
storage dumps and checkpoints. 

These special statements are arranged alphabetically in the following pages. 

Syntax: 



//ddname DD keyword-parameter [, keyword-par ameter] .. . [comments] 



Special ddnames 

The special data sets are identified by the following ddnames: 

JOBCAT 

JOBLIB 

STEPCAT 

STEPLIB 

SYSABEND 

SYSCHK 

SYSCKEOV 

SYSIN 

SYSMDUMP 

SYSUDUMP 

Code these ddnames only when you want the special data sets. 
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JOBCAT DD Statement 



Purpose: Use the JOBCAT DD statement to define a private VSAM or ICF user catalog for 
the duration of a job. The system searches the private catalog for data sets before it searches 
the master catalog or a private catalog associated with the first quahfier of a data set's name. 

You cannot specify OS CVOLs as JOBCAT. Access to an OS CVOL is possible only with a 
special CVOL pointer in the master catalog. 

References: For more information on VSAM data sets, see the VSAM Administration Guide. 

Syntax: 



//JOBCAT DD DISP= {OLD I SHR},DSNAME=private-catalog-naine[, parameter] .. . [comments] 



Parameters on JOBCAT DD Statements 

Do not specify any unit or volume information. The system obtains the location of the private 
catalog from the master catalog. Do not specify FREE = CLOSE; CLOSE is ignored. 

Relationship to STEPCAT DD Statement 

A JOBCAT DD statement appHes to any job step for which you do not specify a STEPCAT 
DD statement. 

Relationsliip to Other Control Statements 

Concatenating Job Catalogs: To specify more than one private catalog for a job: 

• Code a JOBCAT DD statement. 

• Immediately follow this statement with DD statements that define other private catalogs. 
Omit a ddname from these subsequent DD statements. 

Location in the JCL 

• Place the JOBCAT DD statement after the JOB statement and before the first EXEC 
statement. 

• Place a JOBLIB DD statement, if coded, before a JOBCAT DD statement. 



1 1 -2 M VS/XA JCL Reference 



JOBCAT DD 

Example of the JOBCAT DD Statement 



//EXAMPLE JOB WILLIAMS ,MSGLEVEL=1 

//JOBLIB DD DSNAME=USER.LIB,DISP=SHR 

//JOBCAT DD DSNAME=LYLE,DISP=SHR 

// EXEC PGM=SCAN 

In this example, the JOBCAT DD statement specifies a private catalog. The JOBCAT DD 
statement follows the JOBLIB DD statement. 
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JOBLIB DD Statement 



Purpose: Use the JOBLIB DD statement to: 

• Create a private library. 

• Identify a private library that the system is to search for the program named in each EXEC 
statement PGM parameter in the job. If the system does not find the program in the 
private library, only then does the system search the system Ubraries. 

The private library is a partitioned data set (PDS) on a direct access device. Each member is an 
executable, user-written program. 

Syntax: 



//JOBLIB DD parameter [, parameter] .. . [comments: 



Parameters on JOBLIB DD Statements 

When Retrieving a Cataloged Library: 

• Code the DSNAME parameter. 

• Code the DISP parameter. The status subparameter must be OLD or SHR. The 
disposition subparameters should indicate what you want done with the private library after 
its use in the job. 

• Do not code VOLUME or UNIT. 

When Retrieving a Library that is not Cataloged: 

• Code the DSNAME parameter. 

• Code the DISP parameter. The DISP parameter must be DISP = (OLD,PASS) or 
DISP = (SHR,PASS). SHR indicates that the data set is old, but allows other jobs to use 
the library. 

• Code the UNIT parameter. 

• Code the VOLUME parameter. 
When Creating a Library: 

• Code the DSNAME parameter to assign the library a name. 

• Code the UNIT parameter. The hbrary must be allocated to a direct access device. 

• Code a VOLUME parameter, unless a nonspecific request is to be made for any volume. 

• Code the SPACE parameter, allowing enough space for the entire library on one direct 
access volume. Specify space for the PDS directory. 
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• Code a DISP parameter. The status is NEW. Code CATLG as the disposition, if you 
intend to keep the library you are creating. Code PASS as the disposition, if you wish the 
Ubrary to be available throughout the job, but deleted at job termination. Note that you 
must code a disposition; otherwise, the system assumes DELETE and deletes the hbrary at 
the end of the first step. 

Note: Do not use VSAM for a JOBLIB library. 

When Adding Members to the Library: 

• In the DSNAME parameter, follow the hbrary name with the name of the program being 
added to the Ubrary. For example, DSNAME = LIBRARY(PROGRAM). 

• Code the status in the DISP parameter as MOD. If you cataloged the library when you 
created it, do not code a disposition. Otherwise, code PASS or CATLG. 

• If the JOBLIB Ubrary is being created in the job, the JOBLIB DD DISP specified CATLG, 
and the first step adds a member to it, supply unit and volume information in the first step 
by coding: VOLUME = REF = *. JOBLIB. This parameter is needed because the Ubrary is 
not actually cataloged until the first step completes execution. Otherwise, unit and volume 
information should not be suppUed for a cataloged library. 

• Do not code a SPACE parameter. The JOBLIB DD statement requests space for the entire 
Ubrary. 

Other Parameters: Code the DCB parameter if complete data control block information is not 
contained in the data set label. Do not specify FREE = CLOSE; CLOSE is ignored. 

Relationship to Other Control Statements 

Concatenating Job Libraries: To specify more than one private Ubrary for a job: 

• Code a JOBLIB DD statement. 

• Immediately foUovv' this statement v*'ith DD statements that define other private libraries. 
Omit a ddname from these subsequent DD statements. 

The system searches the Ubraries for the program in the same order as the DD statements. 

Overriding a JOBLIB: If you want the system to ignore the JOBLIB for a particular job step 
and the step does not require another private library, define the system Ubrary on a STEPLIB 
DD statement. For example, specify: 

//STEPLIB DD DSNAME=SYS1.LINKLIB,DISP=SHR 

For this particular job step, the system wiU search SYSl.LINKLIB, as specified on the 
STEPLIB DD statement, for the program requested in the EXEC statement. The system will 
not search the JOBLIB. 
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EXEC Statement COND Parameter: If COND = ONLY is specified on the EXEC statement of 
a job step and a JOBLIB DD statement is being used, the system does not pass the unit and 
volume information to any succeeding steps, and the system must search the catalog for the 
JOBLIB data set's unit and volume information. 



Location in the JCL 

• The JOBLIB DD statement must immediately follow the JOB statement and any JES 
statements. There must be no intervening EXEC or other DD statements between the 
JOBLIB DD statement and the JOB statement. 

• If hbraries are concatenated to the JOBLIB library, the concatenated DD statements must 
immediately follow the JOBLIB DD statement. 

• Do not include a JOBLIB DD statement in an in-stream or cataloged procedure. 

Relationship of a JOBLIB to a STEPLIB 

Use a STEPLIB DD statement to define a private library for one job step in a job. If you 
include a STEPLIB DD statement for a job step and a JOBLIB DD statement for the entire 
job, the system first searches the step library and then the system library for the requested 
program. The system ignores the job library for a step that has a STEPLIB DD statement. 



Examples of the JOBLIB DD Statement 



//PAYROLL JOB JONES ,CLASS=C 

//JOBLIB DD DSNAME=PRIVATE.LIB4,DISP=( OLD, PASS) 

//STEPl EXEC PGM=SCAN 

//STEP2 EXEC PGM=UPDATE 

//DDl DD DSNAME=*. JOBLIB, DISP=( OLD, PASS) 

The private library requested on the JOBLIB DD statement is cataloged. The system passes 
catalog information to subsequent job steps. The system searches for the programs SCAN and 
UPDATE first in PRIVATE.LIB4, then in SYSl.LINKLIB. DD statement DDl refers to the 
private Ubrary requested in the JOBLIB DD statement. 

//PAYROLL JOB FOWLER, CLASS=L 

//JOBLIB DD DSNAME=PRIV. DEPT58,DISP=( OLD, PASS ) , 

// UNIT=3350,VOLUME=SER=D58PVL 

//STEP EXEC PGM=DAY 

//STEP2 EXEC PGM=BENEFITS 

//DDl DD DSNAME=*. JOBLIB, VOLUME=REF=*. JOBLIB, 

// DISP= (OLD, PASS) 

The private Ubrary requested on the JOBLIB DD statement is not cataloged; therefore, unit 
and volume information is specified. The system searches for the programs DAY and 
BENEFITS first in PRIV.DEPT58, then in SYSl.LINKLIB. DD statement DDl refers to the 
private library requested in the JOBLIB DD statement. 
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//TYPE JOB MSGLEVEL= (1,1) 

//JOBLIB DD DSNAME=GR0UP8. LEVELS, DISP=( NEW, CATLG ) , 

// UNIT=3350,VOLUME=SER=148562, 

// SPACE=(CYL, (50,3,4) ) 

//STEPl EXEC PGM=DISC 

//DDA DD DSNAME=GROUP8.LEVEL5(RATE) ,DISP=MOD, 

// VOLUME=REF=*. JOBLIB 

//STEP2 EXEC PGM=RATE 

The private library requested on tlie JOBLIB DD statement does not exist yet; therefore, the 
JOBLIB DD statement contains all the parameters required to define the library. The library is 
created in STEPl, when DD statement DDA defines the new member RATE for the library. 
Therefore, the system searches SYSl.LINKLIB for the program named DISC. In STEP2, the 
system searches for the program RATE first in GROUPS. LEVELS. 

//PAYROLL JOB BIRDSALL ,TIME=1440 

//JOBLIB DD DSNAME=KRG.LIB12,DISP=( OLD, PASS) 

// DD DSNAME=GR0UP31. TEST, DISP=( OLD, PASS) 

// DD DSNAME=PGMSLIB,UNIT=3350, 

// DISP=( OLD, PASS) ,VOLUME=SER=34568 

The three DD statements concatenate the three private libraries. The system searches the 
libraries for each program in this order: 

KRG.LIB12 
GROUPS 1. TEST 
PGMSLIB 
SYSl.LINKLIB 
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STEPCAT DD Statement 

Purpose: Use the STEPCAT DD statement to define a private VSAM or ICF user catalog for 
the duration of a job step. The system searches the private catalog for data sets before it 
searches the master catalog or a private catalog associated with the first qualifier of a data set's 
name. 

You cannot specify OS CVOLs as STEPCAT. Access to an OS CVOL is possible only with a 
special CVOL pointer in the master catalog. 

References: For more information on VSAM data sets, see VSAM Administration Guide. 

Syntax: 



//STEPCAT DD DISP={OLD| SHR} ,DSNA]y[E=private-catalog-name [, parameter] . . . [comments] 



Parameters on STEPCAT DD Statements 

Do not specify any unit or volume information. The system obtains the location of the private 
catalog from the master catalog. Do not specify FREE = CLOSE; CLOSE is ignored. 

Relationship to Other Control Statements 

Concatenating Step Catalogs: To specify more than one private catalog for a step: 

• Code a STEPCAT DD statement. 

• Immediately follow this statement with DD statements that define other private catalogs. 
Omit a ddname from these subsequent DD statements. 

Overriding a JOBCAT: To override a JOBCAT private catalog with the master catalog for a 
particular job step, code the following in the job step: 

//STEPCAT DD DISP=OLD ,DSNAME=master-catalog-name 

Location in tlie JCL 

Place a STEPCAT DD statement in any position among the DD statements for a step. 

Example of the STEPCAT DD Statement 



// EXEC PR0C=SNZ12 

//STEPCAT DD DSNAME=BETTGER,DISP=SHR 

The STEPCAT DD statement specifies a private catalog that the system uses for this job step 
only. 
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STEPLIB DD Statement 



Purpose: Use the STEPLIB DD statement to: 

• Create a private library, 

• Identify a private library that the system is to search for the program named in the EXEC 
statement PGM parameter. If the system does not find the program in the private library, 
only then does the system search the system libraries. 

The private library is a partitioned data set (PDS) on a direct access device. Each member is an 
executable, user-written program. 

Subsequent job steps in the same job may refer to or receive a private library defined on a 
STEPLIB DD statement. Also, you can place a STEPLIB DD statement in an in-stream or 
cataloged procedure. 

Syntax: 



//STEPLIB DD parameter [, parameter] .. . [comments] 



Parameters on STEPLIB DD Statements 

When Retrieving a Cataloged Library: 

• Code the DSNAME parameter. 

• Code the DISP parameter. The status subparameter must be OLD or SHR. The 
disposition subparameters should indicate what you want done with the private hbrary after 
its use in the job step. 

• Do not code VOLUIVIE or UNIT. 

When Retrieving a Library Passed from a Previous Step: In the passing job step, code a DISP 
disposition subparameter of PASS when a step library is to be used by subsequent steps in the 
job. 

In a receiving step: 

• Code in the DSNAIVIE parameter either the name of the step library or a backward 
reference of the form *.stepname.STEPLIB. If the step library is defined in a procedure, 
the backward reference must include the procedure step name: 

* . stepname .procstepname. STEPLIB . 

• Code the DISP parameter. The status subparameter must be OLD. The disposition 
subparameters should indicate what you want done with the private library after its use in 
the receiving step. 
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When Retrieving a Library that is Neither Cataloged Nor Passed: 

• Code the DSNAME parameter. 

• Code the DISP parameter. The status subparameter must be OLD or SHR. The 
disposition subparameters should indicate what you want done with the private library after 
its use in the job step. 

• Code the UNIT parameter. 

• Code the VOLUME parameter. 
When Creating a Library: 

• Code the DSNAME parameter to assign the library a name. 

• Code the UNIT parameter. The library must be allocated to a direct access device. 

• Code a VOLUME parameter, unless a nonspecific request is to be made for any volume. 

• Code the SPACE parameter, allowing enough space for the entire library on one direct 
access volume. Specify space for the PDS directory. 

• Code a DISP parameter. The status is NEW. Code CATLG as the disposition, if you 
intend to keep the library you are creating. Code PASS as the disposition, if you wish the 
library to be available to a following step. Note that you must code a disposition; 
otherwise, the system assumes DELETE and deletes the library at the ciid of the step. 

Note: Do not use VSAM for a STEPLIB library. 

When Adding Members to the Library: 

• In the DSNAME parameter, follow the Ubrary name with the name of the program being 
added to the Ubrary. For example, DSNAME = LIBRARY(PROGRAM). 

• Code the status in the DISP parameter as MOD. If the library is cataloged, do not code a 
disposition. Otherwise, code PASS or CATLG. 

• If the library is cataloged, do not code unit and volume information. Otherwise, code 
UNIT and VOLUME. 

• Do not code a SPACE parameter. The STEPLIB DD statement requests space for the 
entire library. 

Other Parameters: Code the DCB parameter if complete data control block information is not 
contained in the data set label. Do not specify FREE = CLOSE; CLOSE is ignored. 
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Relationship to Other Control Statements 

Concatenating Step Libraries: To specify more than one private library for a step: 

• Code a STEPLIB DD statement. 

• Immediately follow this statement with DD statements that define other private libraries. 
Omit a ddname from these subsequent DD statements. 

The system searches the Ubraries for the program in the same order as the DD statements. 

Overriding a JOBLIB: If you want the system to ignore the JOBLIB for a particular job step 
and the step does not require another private hbrary, define the system library on a STEPLIB 
DD statement. For example, specify: 

//STEPLIB DD DSNAME=SYS1.LINKLIB,DISP=SHR 

For this particular job step, the system will first search SYSl.LINKLIB, as specified on the 
STEPLIB DD statement, for the program requested in the EXEC statement. The system will 
not search the JOBLIB. 

Location in the JCL 

Place a STEPLIB DD statement in any position among the DD statements for a step. 

If libraries are concatenated to the STEPLIB library, the concatenated DD statements must 
immediately follow the STEPLIB DD statement. 

Relationship of a STEPLIB to a JOBLIB 

Use a JOBLIB DD statement to define a private library that the system is to use for an entire 
job. If you include a JOBLIB DD statement for the job and a STEPLIB DD statement for an 
individual job step, the system first searches the step library and then the system Ubrary for the 
program requested in the EXEC statement. The system ignores the JOBLIB library for that 
step. 
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Examples of the STEPLIB DD Statement 



//PAYROLL JOB BROWN ,MSGLEVEL=1 
//STEPl EXEC PR0C=LAB14 
EXEC PGM=SPKCH 

DSNAME=PRIV . LIBS , DISP= ( OLD , KEEP ) 
//STEP3 EXEC PGM=TIL80 
//STEPLIB DD DSNAME=PRIV.LIB12,DISP=(0LD,KEEP) 



//STEP2 
//STEPLIB DD 



The system searches PRIV.LIB5 for the program SPKCH and PRIV.LIB12 for TIL80. The 
system catalogs both private libraries. 



//PAYROLL JOB BAKER, MSGLEVEL=1 

//JOBLIB DD DSNAME=LIB5.GROUP4,DISP=( OLD, PASS) 

//STEPl EXEC PR0C=SNZ12 

//STEP2 EXEC PGM=SNAP10 

//STEPLIB DD DSNAME=LIBRARYP,DISP= (OLD, PASS ) , 

// UNIT=3350,VOLUME=SER=55566 

//STEPS EXEC PGM=A1530 

//STEP4 EXEC PGM=SNAP11 

//STEPLIB DD DSNAME=*.STEP2. STEPLIB, 



// 



DISP=( OLD, KEEP) 



The system searches LIBRARY? for program SNAP 10; LIBRARYP is passed to subsequent 
steps of this job. The STEPLIB DD statement in STEP4 refers to the LIBRARYP library 
defined in STEP2; the system searches LIBRARYP for SNAPll. Since a JOBLIB DD 
statement is included, the system searches for programs SNZ12 and A 1530 first in 
LIB5.GRQUP4, tlien in SYSIXINKLIB. 

//PAYROLL JOB THORNTON ,MSGLEVEL=1 

//JOBLIB DD DSNAME=LIB5.GROUP4,DISP=( OLD, PASS) 

//STEPl EXEC PGM=SUM 

//STEPLIB DD DSNAME=SYS1.LINKLIB,DISP=0LD 

//STEP2 EXEC PGM=VARY 

//STEP3 EXEC PGM=CALC 

//STEPLIB DD DSNAME=PRIV. WORK, DISP=( OLD, PASS) 

// DD DSNAME=LIBRARYA,DISP= (OLD, KEEP ) , 

// UNIT=3350,VOLUME=SER=44455 

// DD DSNAME=LIB.DEPT88,DISP=( OLD, KEEP) 

//STEP4 EXEC PGM=SHORE 

For STEP2 and STEP4, the system searches the private library named LIB5.GROUP4 defined 
in the JOBLIB DD statement first for programs VARY and SHORE. For STEPl, the system 
searches SYSl.LINKLIB first for program SUM, because the STEPLIB DD statement names 

the system library. 

A concatenation of private hbraries is defined in STEP3. The system searches for the program 
named CALC in this order: PRIV.WORK, LIBRARYA, LIB.DEPT88, SYSl.LINKLIB. If a 
later job step refers to the STEPLIB DD statement in STEPS, the system will search for the 
program in the private library named PRIV.WORK and, if it is not found there, in 
SYSl.LINKLIB; the concatenated Hbraries are not searched. 
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SYSABEND, SYSMDUMP, and SYSUDUMP DD Statements 

Purpose: Use a SYSABEND, SYSMDUMP, or SYSUDUMP DD statement in a job step to 
direct the system to produce a dump. The system produces the requested dump: 

• If the step terminates abnormally. 

• If the step starts to terminate abnormally, but system recovery procedures enable the step 
to terminate normally. 

The DD statements for the requested dumps are: 

SYSABEND DD statement 

Produces a dump of user and system areas; this dump contains all the areas dumped in a 
SYSUDUMP plus the local system queue area (LSQA), including subpools 229 and 230, 
and the input/output system (lOS) control blocks for the failing task. The dump is 
formatted, so that it can be printed directly. 

SYSMDUMP DD statement 

Produces a dump of the system areas and the program's address space. The dump is 
unformatted and machine-readable; to be used, it must be printed by the PRDUMP 
service aid or by the interactive problem control system (IPCS). 

SYSUDUMP DD statement 

Produces a dump of user areas. The dump is formatted, so that it can be printed directly. 

The dump contents are as described only when the installation uses the IBM-supplied defaults 
for the dumps. The contents of these dumps can be set during system initialization and/or can 
be changed for an individual dump in the ABEND macro instruction, in a CHNGDUMP 
command, and by a SLIP command. For details, see SPL: Initialization and Tuning. 

References: For information on how to interpret dumps, see Debugging Handbook and 
Diagnostic Techniques. 

Syntax: 



//SYSABEND DD parameter [, parameter ].. . [comments] 
//SYSMDUMP DD parameter [, parameter ]. .. [comments] 
//SYSUDUMP DD parameter [, parameter ].. . [comments] 



Location in the JCL 

Do not place in the same job step two DD statements with the same dump ddname. 

Storing a Dump 

If you wish to store a dump instead of having it printed, code the following parameters on the 
dump DD statement: 

I, • The DSNAME parameter. 

• The UNIT parameter. 
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• The VOLUME parameter. 

• The DISP parameter. The data set's status is NEW. Because you want to store the data 
set, make the data set's abnormal termination disposition KEEP or CATLG. 

• The SPACE parameter, if the dump is written on direct access. 

Note: Do not use VSAM for dump data sets. 

SYSMDUMP Requirements: The SYSMDUMP DD statement must specify a magnetic tape 
unit, a direct access device, or a sysout data set. 

To write more than one SYSMDUMP dump in the same data set on tape, specify the 
following: 

• DSNAME = SYSl .SYSMDPxx where xx is 00 through FF. SYSMDPxx is a preallocated 
data set that you must initiaUze with an end-of-file (EOF) mark on the first record. 

• DISP = SHR 

You can ask the system to write additional dumps only if you off-load any previous dump and 
write an EOF mark at the beginning of the SYSl. SYSMDPxx data set. To accompUsh this, 
your installation must install an exit routine for message IEA993. For information on this exit 
routine, see SPL: User Exits. 

Printing a Dump 

To print a dump for either a SYSABEND or SYSUDUMP DD statement, code one of the 
following on the DD statement for the output data set: 

• A UNIT parameter that specifies a printer. 

• The SYSOUT parameter that specifies a print output class. 

To print a dump for a SYSMDUMP DD statement, use one of the following programs: 

PRDMP service aid 

This program is described in SPL: Service Aids. When using PRDMP, the SYSMDUMP 
DD statement must allocate the dimip data set to a magnetic tape or a direct access 
device. 



IPCS 

This program is described in Interactive Problem Control System (IPCS) User's Guide and 
Reference. When using IPCS, the data set disposition affects the collection of events. 

If you print the dump in a JESS system on a 3800 Printing Subsystem, code 

CHARS = DUMP for a dump with 204 characters per line and FCB = STD3 for 8 lines 

per inch. 
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Overriding Dump DD Statements 



To change the type of dump requested in a dump DD statement in a cataloged or in-stream 
procedure, the ddname of the overriding DD statement in the calling step must be different 
from the dump ddname of the procedure DD statement. 

Duplicate Dump Requests 

You can code more than one dump request in a job step using DD statements that have 
different ddnames. When you do this, the system uses the last dump DD statement it 
encounters. 

When the system finds dump DD statements with duplicate ddnames, processing is as follows: 

• In a JES2 system, the job fails with message IEC912I. 

• In a JES3 system: 

- If both DD statements request JES3- or jointly-managed devices, the job is cancelled 
during JES3 interpretation. 

— If only one or neither statement requests JES3- or jointly-managed devices, the job fails 
with message IEC912I. 

Examples of the SYSABEND, SYSMDUMP, and SYSUDUMP DD Statements 



//STEP2 EXEC PGM=A 
//SYSUDUMP DD SYSOUT=A 

The SYSUDUMP DD statement specifies that you want the dump routed to system output 
class A. 

//SYSMDUMP DD DSNAME=DUMP , DISP= (NEW , KEEP) , 
// UNIT=3400-6,VOLUME=SER=147958 

The SYSMDUMP DD statement specifies that the dump is to be stored on a tape. Because the 
LABEL parameter is not coded, the tape must have IBM standard labels. 

//STEPl EXEC PGM=PR0GRAM1 

//SYSABEND DD DSNAME=DUMP ,UNIT=3350 ,DISP= (, PASS , KEEP) , 

// VOLUME=SER=1234,SPACE=(TRK, (40,20) ) 

//STEP2 EXEC PGM=PR0GRAM2 

//SYSABEND DD DSNAME=* . STEPl. SYSABEND, DISP= (OLD, DELETE , KEEP) 

Both SYSABEND DD statements specify that the dump is to be stored. The space request in 
STEPl is ample and will not inhibit dumping due to insufficient space. If STEPl does not 
abnormally terminate but STEP2 does, the system writes the dump for STEP2 in the space 
allocated in STEPl. In both steps, an abnormal termination disposition of KEEP is specified 
so that the dump is stored if either of the steps abnormally terminates. If both of the steps 
successfully execute, the second DISP subparameter, DELETE, in STEP2 instructs the system 
to delete the data set and free the space acquired for dumping. 
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//STEPl EXEC PGM=WWK 

//SYSMDUMP DD DSNAME=DUMP, UNIT=3 350 ,DISP= (, DELETE , 

// KEEP) ,VOLUME=SER=54366,SPACE=(1680, (160,80) ) 

//STEP2 EXEC PGM=IKJEFT01,PARM=AMDPRDMP,COND=ONLY 

//IN DD DSNAME= *. STEP l.SYSUDUMP,DISP=( OLD, DELETE ) , 

// VOLUME=REF=*. STEPl. SYSUDUMP 

STEPl specifies that the dump is to be stored on a direct access device if the step abnormally 
terminates. Because the EXEC COND = ONLY parameter is specified in STEP2, STEP2 is 
executed only if STEPl abnormally terminates. STEP2 executes the PRDMP service aid to 
print the dump. 

//STEP EXEC PGM=EXSYSM 

//SYSMDUMP DD UNIT=3330 , VOLUME=SER=123456 ,SPACE= (CYL , ( , 1) ) , 

// DISP=( NEW, DELETE, KEEP) , DSNAME=MDUMP 

The SYSMDUMP DD statement allocates dump data set MDUMP to a direct access device. 

//STEP EXEC PGM=EXSYSMDP 

//SYSMDUMP DD DSNAME=SYS1 . SYSMDPOO ,DISP=SHR 

The SYSMDUMP is written in data set SYSl.SYSMDPOO. 

Note: When you specify a DSNAME of SYSl .SYSMDPxx and DISP = SHR, the first 
SYSMDUMP produced is retained on the data set. This first SYSMDUMP must be off-loaded 
and an end-of-file mark written at the beginning of the SYSl. SYSMDPxx data set before 
subsequent dumps can be written. 

//STEPA EXEC PGM=EXSYSM2,ADDRSPC=REAL 

//SYSMDUMP DD UNIT=SYSDA , SPACE= ( CYL ,(0,1)), 

// DISP=( NEW, PASS) 

//STEP2 EXEC PGM=IK JEFTO 1 , PARM=AMDPRDMP , COND=ONLY 

//SYSUTl DD DSNAME=*. STEPA. SYSMDUMP, DISP=OLD 

//PRINTER DD SYSOUT=A 

//SYSIN DD * 

FORMAT 

LOGDATA 

END 

/* 

In STEPA, the SYSMDUMP DD statement directs output to a VIO data set (1) by specifying a 
VIO-eligible device group (SYSDA) and (2) by not assigning a data set name to make the data 
set temporary and eligible for VIO. STEPB is executed only if STEPA abnormally terminates. 
In STEPB, the dump output is printed by the PRDMP service aid on a device assigned to 
output class A. 
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SYSCHK DD Statement 



Purpose: Use the SYSCHK DD statement to define a checkpoint data set that the system is to 
write during execution of a processing program. Use this statement again when the step is 
restarted from a checkpoint written in the data set. 

Note: If restart is to begin at a step, as indicated by the RD parameter on the EXEC 
statement, do not use a SYSCHK DD statement. 

References For detailed information about the checkpoint/restart facilities, see 
Checkpoint! Restart User's Guide. 

Syntax: 



//SYSCHK DD parameter [, parameter] .. . [comments] 



Parameters on SYSCHK DD Statements 

When Creating a Checkpoint Data Set: 

• Code a SPACE parameter, but do not request secondary space. 



- The primary space request must be large enough to hold all checkpoints. Although 
your program or the system can write checkpoints in secondary space, the system 
cannot perform a restart from checkpoints in secondary space. 

- If you do not request secondary space and the primary space fills up, the job 
abnormally terminates. You can successfully restart the job at the last checkpoint; 
however, when the processing program or system writes the next checkpoint the job 
abnormally terminates again. 

- If you do request secondary space and the primary space fills up, the processing 
program or the system writes one invahd checkpoint followed by successful 
checkpoints. An attempt to restart from one of the checkpoints following the invahd 
checkpoint results in abnormal termination. 

Code the RLSE subparameter of the SPACE parameter only if the processing program 
opens the checkpoint data set and the checkpoint data set remains open until the end of the 
program. If you specify RLSE, the system releases unused space after the first CLOSE 
macro instruction. 

Do not code the RLSE subparameter: 

- If the processing program opens the checkpoint data set before writing each checkpoint 
and closes the checkpoint data set after writing each checkpoint. The system releases 
all unused space while closing the data set after the first checkpoint, leaving no space 
for additional checkpoints. 

- If the system opens the checkpoint data set. The system opens and closes the 
checkpoint data set before it writes the first checkpoint. With RLSE specified, the 
system would release all space before the first checkpoint could be written. 
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• Code the CONTIG subparameter of the SPACE parameter to request contiguous space. 
The system otherwise provides additional primary space using extents. If the extents are 
not contiguous, any checkpoints in these extents cannot be used for a successful restart. 

When Retrieving a Cataloged Checkpoint Data Set: 

• Code the DSNAME parameter. 

• Code the DISP parameter to specify a status of OLD and a disposition of KEEP. 

• Code the VOLUME parameter. If the checkpoint entry is on a tape volume other than the 
first volume of the checkpoint data set, code the volume serial number or volume sequence 
nxraiber to identify the correct volume. The serial number of the volume on which a 
checkpoint entry was written appears in the console message issued after the checkpoint 
entry is written. 

• Code the UNIT parameter, if you coded the VOLUME parameter, because the system will 
not look in the catalog for unit information. 

When Retrieving a Checkpoint Data Set that is not Cataloged: 

• Code the DSNAME parameter. If the checkpoint data set is partitioned, do not code a 
member-name in the DSNAME parameter. 

• Code the DISP parameter to specify a status of OLD and a disposition of KEEP. 

• Code the VOLUME parameter. The serial number of the volume on which a checkpoint 
entry was written appears in the console message issued after the checkpoint entry is 
written. 

• Code the UNIT parameter. 
Other Parameters: 

• Code the LABEL parameter if the checkpoint data set does not have standard labels. 

• Code DCB = TRTCH = C if the checkpoint data set is on 7-track magnetic tape with 
nonstandard labels or no labels. 

• If the volume containing the checkpoint data set is to be mounted on a JES3 -managed 
device, do not code the DEFER subparameter of the UNIT parameter on the SYSCHK 
DD statement. 

Note: Do not use VSAM for checkpoint data sets. 

Relationship to Other Control Statements 

Code the RESTART parameter on the JOB statement; without it, the system ignores the 
SYSCHK DD statement. 
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Location in the JCL 



• When writing checkpoints, place the SYSCHK DD statement after any JOBLIB DD 
statements, if coded; otherwise, after the JOB statement. 

• When restarting a job from a checkpoint, place the SYSCHK DD statement immediately 
before the first EXEC statement of the resubmitted job. 

Examples of the SYSCHK DD Statement 



//JOBl JOB RESTART=(STEP3,CK3) 
//SYSCHK DD DSNAME=CHLIB,UNIT=3350, 
// DISP=OLD,VOLUME=SER=456789 

//STEPl EXEC PGM=A 

The checkpoint data set defined on the SYSCHK DD statement is not cataloged. 

// J0B2 JOB RESTART= ( STEP2 , N0TE2 ) 
//JOBLIB DD DSNAME=PRIV.LIB3,DISP=( OLD, PASS) 
//SYSCHK DD DSNAME=CHECKPTS, DISP=( OLD, KEEP ) , 
// UNIT=3400-6,VOLUME=SER=438291 

//STEPl EXEC PGM=B 

The checkpoint data set defined on the SYSCHK DD statement is not cataloged. Note that the 
SYSCHK DD statement follows the JOBLIB DD statement. 
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SYSCKEOV DD Statement 

Purpose: Use the SYSCKEOV DD statement to define a checkpoint data set for checkpoint 
records from the checkpoint at end-of-volume (EOV) facility. The checkpoint at EOV facility is 
invoked by a DD CHKPT parameter. 

References: For information on the DD CHKPT parameter, see "CHKPT Parameter" on 
page 10-27. For information on checkpoint/restart faciHties, see Checkpoint I Restart User's 
Guide. 

Syntax: 



//SYSCKEOV DD parameter [, parameter ].. . [comments] 



Parameters on SYSCKEOV DD Statements 
When Creating a Checkpoint Data Set: 

• Code a SPACE parameter, but do not request secondary space. The primary space request 
must be large enough to hold all checkpoints; if not, the job abnormally terminates. 

• Do not code the RLSE subparameter of the SPACE parameter. 

O Code the CONTIG subparameter of the SPACE parameter to request contiguous space. 
The system otherwise provides additional primary space using extents. 

• The SYSCKEOV DD statement must define a BSAM data set. 

• Code DISP = MOD to reduce loss of checkpoint data in case of a system failure during 
checkpointing. 

Other Parameters: 

• Do not code on the SYSCKEOV DD statement the following: 

- CHKPT = EOV parameter. 

- DCB parameter. All DCB information is provided by the checkpoint at EOV facility. 

- DEFER subparameter of the UNIT parameter. 

• If you code the LABEL parameter, you must specify LABEL = (,SL) for IBM standard 
labels. 

• If the SYSCKEOV data set resides on a direct access storage device, that device cannot be 
shared with another processor. 
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Location in the JCL 



If you code a CHKPT parameter on any DD statements in a job step, place a SYSCKEOV DD 
statement in the DD statements for the step. 

Example of the SYSCKEOV DD Statement 



//SYSCKEOV DD DSNAME=CKPTDS ,UNIT=TAPE ,DISP=MOD 

This statement defines a checkpoint data set for checkpoint at EOV records. 
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SYSIN DD Statement 



Purpose: Use a SYSIN DD statement to begin an in-stream data set. In-stream data sets 
begin with a DD * or DD DATA statement; these DD statements can have any valid ddname, 
including SYSIN. If you omit a DD statement before input data, the system provides a DD * 
statement with the ddname of SYSIN. 

Syntax: 



//SYSIN DD parameter [, parameter] .. . [comments] 



Parameters on SYSIN DD Statements 

The first parameter is an * or DATA, to signal that an in-stream data set follows immediately. 

Location in tiie JCL 

A SYSIN DD statement appears at the beginning of an in-stream data set. 

Examples of SYSIN DD Statements 



//STEPl EXEC PGM=READ 
//SYSIN DD * 



CIS. 11.3. 

//OUTl DD SYSOUT=A 

//STEP2 EXEC PGM=WRITE 

//SYSIN DD DATA,DLM=17 



17 
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Chapter 12. Delimiter Statement 



Purpose: Use the delimiter statement to indicate the end of data or transmittal records in the 
input stream. 

Syntax: 



/* [comments] 
XX [comments] 



A delimiter statement consists of the characters /* or the two characters specified in a DLM 
parameter in columns 1 and 2 and one field: comments. 

Do not continue a delimiter statement. 



Comments Field 

The comments field follows the delimiter characters after at least one intervening blank. Code 
any comments in columns 4 through 80. 

Relationship to the DLM Parameter 

The system recognizes a delimiter other than /* if a DLM parameter is coded on: 

• The DD * or DD DATA statement that defines an in-stream data set. 

• The JES2 /*X]V[IT statement that precedes input stream records to be transmitted to 
another node. 

I A delimiter statement is optional: 

I • If the data is preceded by a DD * statement without a DLIVI parameter. 

I • If transmitted records are preceded by an /*X]VIIT statement without a DLIVI parameter. 

Location in the JCL 

A delimiter statement must appear: 

• At the end of an in-stream data set that begins with a DD DATA statement. 

^ • At the end of an in-stream data set that begins with a DD statement containing a DLIVI 

parameter. 
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At the end of records to be transmitted to another node when the records are preceded by 
/*XMIT statement containing a DLM parameter. 



Examples of the Delimiter Statement 



//JOB54 JOB , • C BROWN ' ,MSGLEVEL= (2,0) 
//STEPA EXEC PGM=SERS 
//DDl DD * 



data 

/* END OF DATA FOR DATA SET DDl 
//DD2 DD DATA , DLM=AA 



AA 



data 

END OF DATA FOR DATA SET DD2 
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Chapter 13. ENDCNTL Statement 



Purpose: Use the ENDCNTL statement to mark the end of the program control statements 
following a CNTL statement. 

Syntax: 



//[label] ENDCNTL [comments] 



The ENDCNTL statement consists of the characters // in colimms 1 and 2 and three fields: 
label, operation (ENDCNTL), and comments. 



Label Field 

Code a label on the ENDCNTL statement, as follows: 

• Each label must be unique within the job. 

• The label must begin in column 3. 

• The label is 1 through 8 alphanumeric or national characters. 

• The first character must be alphabetic or national. 

• The label must be followed by at least one blank. 

Operation Field 

The operation field consists of the characters ENDCNTL and must be preceded and followed 
by at least one blank. It can begin in any column. 

Comments Field 

The comments field follows the ENDCNTL after at least one intervening blank. 

Location in the JCL 

The ENDCNTL statement immediately follows the one or more program control statements 
following a CNTL statement. Thus, the ENDCNTL statement can appear in a job step or in a 
cataloged or in-stream procedure. 
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Example of the ENDCNTL Statement 



//STEPl EXEC PGM=PRINT 

//ABLE CNTL 

//STATEl PRINTDEV BUFNO=20 ,PIMSG=YES ,DATACK=BLOCK 

//BAKER ENDCNTL 

//CALLER DD UNIT==3800-3 ,CNTL=* . ABLE 
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Chapter 14. EXEC Statement 



Purpose: Use the EXEC (execute) statement to identify the program or cataloged or in-stream 
procedure that this job step is to execute and to tell the system how to process the job step. 
The EXEC statement marks the beginning of each step in a job or a procedure. 

A job can have a maximum of 255 job steps. This maximum includes all steps in any 
procedures the EXEC statements call. 

The parameters you can specify for step processing are arranged alphabetically in the following 
pages. 

References: For information about the JES initialization parameters that provide installation 
defaults, see SPL: JES2 Initialization and Tuning and SPL: JESS Initialization and Tuning. 

Syntax: 



//[stepname] EXEC positional-parameter [, keyword-par ameter] .. . [comments] 



The EXEC statement consists of the characters // in columns 1 and 2 and four fields: name, 
operation (EXEC), parameter, and comments. 

An EXEC statement is required for each job step. 



Name Field 



A stepname is optional, but is needed for the following. When a stepname is needed, it must be 
unique within the job, including stepnames in any procedures called by the job. 

• Referring to the step in later job control statements. 

• Overriding parameters on an EXEC statement or DD statement in a cataloged or in-stream 
procedure step. 

• Adding DD statements to a cataloged or in-stream procedure step. However, a stepname is 
not required when adding to the first step in a procedure. 

• Performing a step or checkpoint restart at or in the step. 

• Identifying a step in a cataloged or in-stream procedure. 
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Code a stepname as follows: 






The stepname must begin in column 3. 

The stepname is 1 through 8 alphanumeric or national characters. 

The first character must be alphabetic or national. 

The stepname must be followed by at least one blank. 



Operation Field 



The operation field consists of the characters EXEC and must be preceded and followed by at 
least one blank. It can begin in any column. 



Parameter Field 



An EXEC statement has two kinds of parameters: positional and keyword. 

Do not use EXEC statement parameter keywords as symbolic parameters, names, or labels. 

Positional Parameters: An EXEC statement must contain one of the positional parameters: 
PGM, PROC, or procedure name. This positional parameter must precede all keyword 
parameters. 



POSITIONAL PARAMETERS 


VALUES 


PURPOSE 


PGM = 

See page 


program-name 

*.stepname.ddname 

♦.stepname.procstepname.ddname 

JCLTEST 

JSTTEST 

14-22 




program-name: 1-8 alphanumeric or 

national characters 
ddname: name of DD for PDS 

member containing program 
stepname: DD in named step 
procstepname: step in named procedure 
JCLTEST and JSTTEST: scan for syntax 

without executing step (JES3 only) 


Names the program the system is 
to execute Of, foi JESS only, 
requests syntax check without 
execution. 


PROC = procedure-name 
procedure-name 

See page 14-24 




procedure-name: 1 - 8 alphanumeric or 
national characters 


Names the cataloged or in-stream 
procedure the system is to call 
and execute. 



Keyword Parameters: An EXEC statement can contain the following keyword parameters. 
You can code any of the keyword parameters in any order in the parameter field after the 
positional parameter. 



KEYWORD PARAMETERS 


VALUES 


PURPOSE 


ACCT[.procstepname] = (accounting-information) 
See page 14-5 


accounting-information: up to 142 characters 
[.procstepname]: name of procedure EXEC 
containing ACCT to be affected 


Specifies accounting information 
for the step. 


ADDRSPC[.procstepname] = 
See page 14-7 


VIRT 
REAL 


. 


VIRT: virtual (pageable) storage 
REAL: real (nonpageable) storage 
[.procstepname]: name of procedure EXEC 
containing ADDRSPC to be affected 


Indicates the type of storage 
required for the step. 
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KEYWORD PARAMETERS 


VALUES 


PURPOSE 


COND[.procstepname] = 


code: - 4095 


Specifies the return code tests used 


/ (code,operator[,stepname][.procstepname]) \ 


operator: GT Code from 


to determine if this step is to be 


[,(code,operator[,stepname][.procstepname]) ...]\ 


GE chart on 


executed or bypassed. 




■ 




EQ page 14-13 






,EVEN 




NE 




\ 


,ONLY 


/ 


LT 




1 L. Jl f 


LE 
EVEN: execute step even if preceding step 

abnormally terminated 
ONLY: execute step only if preceding step 

abnormally terminated 
stepname: step issuing return code 
procstepname: step is in named procedure 

[.procstepname]: name of procedure EXEC 
containing COND to be affected 




See page 14-9 






DPRTY[.procstepname] = ([valuel][,value2]) 


valuel: 0-15 


Assigns a dispatching priority for 




value2: 0-15 


the address space: dispatching 




[.procstepname]: name of procedure EXEC 


priority = (valuel * 16) + value2 




containing DPRTY to be affected 




See page 14-15 






DYNAMNBR[.procstepname] = n 


n: - 1635 minus number of DD statements 


Holds a number of data set 




in step 


allocations for reuse. 




[.procstepname]: name of procedure EXEC 






containing DYNAMNBR to be affected 




See page 14-17 






PARM[.procstepname] = information 


information: up to 100 characters 


Passes variable information to the 




[.procstepname]: name of procedure EXEC 


processing program. 




containing PARM to be affected 




See page 14-18 






PERFORM[.procstepname] = n 


n: 1 - 999 


Specifies the step's performance 




[.procstepname]: name of procedure EXEC 


group, which determines the rate 




containing PERFORM to be affected 


at which the step has access to the 
processor, storage, and channels. 


See page 14-20 






RD[.procstepname] = R 




R: restart, checkpoints allowed 


Indicates whether the operator 


RNC 




RNC: restart, no checkpoints 


should perform automatic step 


NR 




NR: no restart, checkpoints allowed 


restart, if the step fails, and 


!nc 




NC: no restart, no checkpoints 


controls whether checkpoints are 


' 


[.procstepname]: name of procedure EXEC 


written for CHKPT macros or 




containing RD to be affected 


DD statement CHKPT 
parameters. 


See page 14-25 






REGION[.procstepname] = 


valueK 




valueK: even number, 1 - 7 digits 


Specifies the amount of space in 




valueM 




from 1 - 2096128 


kilobytes or megabytes required 


' 


valueM: even or odd number, 1 - 4 digits 


by the step. 




from 1 - 2047 






[.procstepname]: name of procedure EXEC 






containing REGION to be affected 




See page 14-29 






TIME[.procstepname] = 


([minutes][,seconds]) 




minutes: 1-1439 


Specifies the maximum time the 




1440 




seconds: 1 - 59 


step is to use the processor and 




[.procstepname]: name of procedure EXEC 


requests messages giving the time 




containing TIME to be affected 


used. 


Seepage 14-31 
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EXEC 



Keyword Parameters on EXEC Statement that Calls a Procedure: When the EXEC statement 
positional parameter calls a cataloged or in-stream procedure, all of the EXEC statement's 
keyword parameters override matching EXEC keyword parameters in the called procedure. If a 
keyword parameter is to override a parameter on only one EXEC statement in the procedure, 
code .procstepname immediately following the keyword: 

keyword. procstepname=value 

The procstepname is the name field on the procedure EXEC statement containing the keyword 
parameter to be overridden. For example: 

//STEPl EXEC PROC=WKREPORT,ACCT.PSTEPWED=5670 

The accounting information 5670 applies only to step PSTEPWED in the procedure 
WKREPORT. 

Comments Field 

The comments field follows the parameter field after at least one intervening blank. 

Location in the JCL 

An EXEC statement must be the first statement in each job step or cataloged or in-stream 
procedure step. 



Examples of EXEC Statements 



//STEP4 EXEC PGM=DREC,PARM='3018,NO' 

The EXEC statement named STEP4 invokes a program named DREC and passes the value in 
the PARM parameter to DREC. 

// EXEC PGM=ENTRY,TIME=(2,30) 

This EXEC statement, which does not have a stepname, invokes a program named ENTRY 
and specifies the maximum processor time for execution of the step. 

//FOR EXEC PROC=PROC489,ACCT=DB1528,RD.PSTEP2=RNC,DEV=3350 

The EXEC statement named FOR invokes a cataloged or in-stream procedure named 
PROC489. The ACCT parameter applies to all steps in the procedure. The RD parameter 
applies to only the step named PSTEP2. The DEV parameter assigns the value 3350 to the 
symbolic parameter &DEV in a procedure statement. 
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ACCT Parameter 



Parameter Type: Keyword, optional 

Purpose: Use the ACCT parameter to specify one or more subparameters of accounting 
information that apply to this step. The system passes the accounting information to the 
installation's accounting routines. 

References: For more information on how to add accounting routines, see SPL: System 
Management Facilities. 

Syntax: 




Single Subparameter: You can omit the parentheses if the accounting information consists of 
only one subparameter. 

Length: The entire accounting-information must not exceed 142 characters; 

• Including any commas, which are considered part of the information. 

• Excluding any enclosing parentheses or apostrophes, which are not considered part of 
the information. 

Multiple Subparameters: When the accounting-information consists of more than one 
subparameter, separate the subparameters by commas and enclose the information in 
parentheses or apostrophes. For example, ACCT = (5438,GROUP6) or 
ACCT = '5438,GROUP6'. 

Special Characters: When a subparameter contains special characters, other than hyphens or 
plus zero ( + 0, an overpunch), enclose it in apostrophes and the information in parentheses 
or enclose all of the information in apostrophes. For example, ACCT = (387,72/159') or 
ACCT = '387,72/1 59'. 

Code each apostrophe that is part of the accounting-information as two consecutive 
apostrophes. For example, code DEPT'D58 as ACCT = 'DEPT"D58' 

Continuation onto Another Statement: Enclose the accounting-information in parentheses. 
End each statement with a comma after a complete subparameter. For example: 

//STEPl EXEC PGM=WRITER,ACCT={1417,J318, 'D58/920' , •CHG=2' , 
// '33.95') 
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Subparameter Definition 

accounting-information 

Specifies one or more subparameters of accounting information, as defined by the 
installation. 

On EXEC Statement that Calls a Procedure 

If the EXEC statement calls a cataloged or in-stream procedure, the ACCT parameter overrides 
the ACCT parameter on or is added to: 

• The EXEC statement named in the procstepname qualifier. The information applies only 
to the named procedure step. The EXEC statement can have as many ACCT. procstepname 
parameters as the procedure has steps; each ACCT parameter must specify a unique 
procstepname. 

• All EXEC statements in the procedure if procstepname is not coded. Then the information 
applies to all steps in the called procedure. 

Examples of the ACCT Parameter 



//STEPl EXEC PGM= JP5,ACCT=( LOCATIONS, 'CHGE+S' ) 

This EXEC statement executes program JP5 and specifies accounting information for this job 
step. 

//STP3 EXEC PROC=LOOKUP ,ACCT= ( ' /83468 ' ) 

This EXEC statement calls cataloged or in-stream procedure LOOKUP. The accounting 
information applies to this job step, STP3, and to all the steps in procedure LOOKUP. 

//STP4 EXEC PROC=BILLING,ACCT.PAID=56370,ACCT.LATE=56470, 
// ACCT. BILL=' 121+366' 

This EXEC statement calls cataloged or in-stream procedure BILLING. The statement 
specifies different accounting information for each of the procedure steps: PAID, LATE, and 
BILL. 
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ADDRSPC Parameter 



Parameter Type: Keyword, optional 

Purpose: Use the ADDRSPC parameter to indicate to the system that the job step requires 
virtual storage (pageable) or real storage (nonpageable). 

Syntax: 



ADDRSPC [ .procstepname] = 


VIRT 
REAL 





Subparameter Definition 
VIRT 



Defaults 



Requests virtual storage. The system can page the job step. 

REAL 

Requests real storage. The system cannot page the job step and must place the job step in 
real storage. 



If no ADDRSPC parameter is specified, the default is VIRT. 



Overrides 

The JOB statement ADDRSPC parameter apphes to all steps of the job and overrides any 
EXEC statement ADDRSPC parameters. 

Code EXEC statement ADDRSPC parameters when each job step requires different types of 
storage. The system uses an EXEC statement ADDRSPC parameter only when no ADDRSPC 
parameter is on the JOB statement and only during the job step. 

Relationship to the EXEC REGION Parameter 

When ADDRSPC = REAL: Code a REGION parameter to specify how much real storage the 
job needs. If you omit the REGION parameter, the system uses the default. 

When ADDRSPC '^ VIRT or ADDRSPC is Omitted: Code a REGION parameter to specify 
how much virtual storage the job needs. If you omit the REGION parameter, the system uses 
the default. 
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On EXEC Statement that Calls a Procedure 

If this EXEC statement calls a cataloged or in-stream procedure, the ADDRSPC parameter 
overrides the ADDRSPC parameter on or is added to: 

• The EXEC statement named in the procstepname qualifier. The parameter applies only to 
the named procedure step. The EXEC statement can have as many 
ADDRSPC.procstepname parameters as the procedure has steps; each ADDRSPC 
parameter must specify a unique procstepname. 

• All EXEC statements in the procedure if procstepname is not coded. Then the parameter 
applies to all steps in the called procedure. 

Examples of the ADDRSPC Parameter 



//CACl EXEC PGM=A,ADDRSPC=VIRT 

This EXEC statement executes program A and requests virtual (pageable) storage. Because the 
REGION parameter is not specified, the storage available to this job step is the installation 
default or the region size specified on the JOB statement. 

//CAC2 EXEC PROC=B,ADDRSPC=REAL,REGION=80K 

This EXEC statement calls procedure B and requests real (nonpageable) storage. The 
REGION parameter specifies 80K of storage. 



14-8 MVS/XA JCL Reference 



EXEC: COND 



COND Parameter 



Parameter Type: Keyword, optional 

Purpose: Use the COND parameter to specify the return code tests the system is to use to 
determine whether to bypass or execute this job step. The system performs each COND 
parameter test against the return code from every previous job step that executed or from the 
named previous job step(s). If none of these tests is satisfied, the system executes this job step; 
if any test is satisfied, the system bypasses this job step. 

Bypassing a step because of a return code test is not the same as abnormally terminating the 
step. The system abnormally terminates a step following an error so serious that it prevents 
successful execution. In contrast, bypassing of a step is merely its omission. 

If a step abnormally terminates, the system normally bypasses all following steps in the job. To 
make the system execute a following step, for instance, to write a dump, code EVEN or ONLY 
on that step's EXEC statement. The EVEN or ONLY subparameters are interpreted first. If 
they indicate that the step should be executed, then the return code tests, if specified, are 
performed. If no return code tests were coded or if none of the coded tests is satisfied, the 
system executes the step. 

Instead of coding a JOB statement COND parameter, code an EXEC statement COND 
parameter when you want to: 

• Specify different tests for each job step. 

• Name a specific step whose return code the system is to test. 

• Specify special conditions for executing a job step. 

• Bypass only one step. When a step is bypassed because of a JOB COND parameter, all 
following steps in the job are bypassed. 

A COND parameter on the first EXEC statement in a job is meaningless. 

The tests are made against return codes from the current execution of the job. If a return code 
test specifies a previous step that was bypassed, the test is ignored. 

Note: In both JES2 and JES3 systems, an EXEC COND parameter determines if a step is 
executed or bypassed. However, JES3 processes all jobs as though each step will execute; 
therefore, JES3 allocates devices for steps that are bypassed. 
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Syntax: 



COND[ .procstepname] =( code, operator) 

COND[ .procstepname] = /(code, operator [ ,stepname] [ .procstepname] ) 

, (code, operator [ ,stepname] [ .procstepname] ) ] 



COND=EVEN 
COND=ONLY 



,EVEN 
,ONLY 



• One return code test is: (code,operator) 

• You can omit tlie outer parentheses if you code only one return code test or only EVEN or ONLY. 

• Specify up to eight return code tests. However, if you code EVEN or ONLY, specify up to seven 
return code tests. 

• You can omit all return code tests and code only EVEN or ONLY. 

• Place the EVEN or ONLY subparameters before, between, or after the return code tests. 



Subparameter Definition 
code 



Specifies a number that the system compares to the return codes from all previous steps in 
the job or from specific steps, code is a decimal number from through 4095. 

Note: Specifying a decimal number greater than 4095 could result in invalid return code 
testing or invalid return codes in messages. 

operator 

Specifies the type of comparison to be made to the return code. If the specified test is 
true, the step is bypassed. Use the chart on page 14-13 to select the correct operator. 
Operators and their meanings are: 

Operator Meaning 



GT 


Greater than 


GE 


Greater than or equal to 


EQ 


Equal to 


NE 


Not equal to 


LT 


Less than 


LE 


Less than or equal to 



stepname 

Identifies the EXEC statement of the earlier job step that issues the return code to be used 
in the test. If the specified step is in a procedure, this step must be in the same procedure; 
otherwise, the specified step must not be in a procedure. 
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stepname.procstepname 

Identifies a step in a cataloged or in-stream procedure called by an earlier job step. 
Stepname identifies the EXEC statement of the calUng job step; procstepname identifies 
the EXEC statement of the procedure step that issues the return code to be used in the 
test. 

EVEN 

Specifies that this job step is to be executed even if a preceding job step abnormally 
terminated. When EVEN is coded, the system: 

• Does not test the return code of any steps that terminated abnormally. 

• Does test the return code of any steps that terminated normally. If none of the return 
code tests for these steps is satisfied, this job step is executed. 

If the operator terminated a job step with a CANCEL command, the system ignores 

EVEN. 

ONLY 

Specifies that this job step is to be executed only if a preceding step abnormally 
terminated. When ONLY is coded, the system: 

• Does not test the return code of any steps that terminated abnormally. 

• Does test the return code of any steps that terminated normally. If none of the return 
code tests for these steps is satisfied, this job step is executed. 

If the operator terminated a job step with a CANCEL command, the system ignores 
ONLY. 

Overrides 

If you code the COND parameter on the JOB statement and on one or more of the job's EXEC 
statements, and if a return code test on the JOB statement is satisfied, the job terminates. In 
this case, the system ignores any EXEC statement COND parameters. 

If the tests on the JOB statement are not satisfied, the system then performs the return code 
tests on the EXEC statement. If a return code test is satisfied, the step is bypassed. 

On EXEC Statement that Calls a Procedure 

If this EXEC statement calls a cataloged or in-stream procedure, the COND parameter 
overrides the COND parameter on or is added to: 

• The EXEC statement named in the procstepname quahfier, which is to the left of the equals 
sign. The parameter applies only to the named procedure step. The EXEC statement can 
have as many COND.procstepname parameters as the procedure has steps; each COND 
parameter must specify a unique procstepname. 

• All EXEC statements in the procedure if procstepname is not coded. Then the parameter 
applies to this job step and to all steps in the called procedure. 
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Cautions when Specifying COND Parameters 

Backward References to Data Sets: If a step is bypassed because of its COND parameter or if 
a step abnormally terminates, a data set that was to have been created or cataloged in the step 
may not exist, may not be cataloged, or may be incomplete. Thus, a job step should not refer 
to a data set being created or cataloged in a step that could be bypassed or abnormally 
terminated. 

JOBLIB and COND = ONLY: If the job contains a JOBLIB DD statement and ONLY is 
specified in a job step, the JOBLIB unit and volume information are not passed to the next 
step; when the next step is executed, the system searches the catalog for the JOBLIB data set. 

Job Time Out: The system abnormally terminates a job with a system completion code of 322 
if the EXEC or JOB statement TIME parameter or the default time limit specified at JES 
initialization is exceeded. This time out occurs regardless of any COND parameters. 

When the JOB Statement Contains a RESTART Parameter: When restarting a job, do not 
specify in the deferred restart step or in any following steps a COND parameter that refers to a 
stepname or stepname.procstepname for a step before the restart step. The system ignores any 
COND parameters that refer to preceding steps. 
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Summary of COND Parameters 



Test in COND Parameter 


Return Code (RC) from Previous Step 


Execute 
Current Step 


Bypass 
Current Step 


COND = (code,GT) 
COND = (code,GE) 
COND = (code,EQ) 
COND = (code,LT) 
COND = (code,LE) 
COND = (code,NE) 


RC > code 
RC > code 
RC -1 = code 
RC < code 
RC < code 
RC = code 


RC < code 

RC < code 
RC = code 
RC > code 
RC > code 
RC -1 = code 



Figure 14-1. Execution or Bypassing of Current Step Based on COND Parameter 
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Figure 14-2. Effect of EVEN and ONLY Subparameters on Step Execution 
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Examples of the COND Parameter 



//STEP6 EXEC PGM=DISKUTIL,COND=(4,GT,STEP3) 

In this example, if the return code from STEP3 is through 3, the system bypasses STEP6. If 
the return code is 4 or greater, the system executes STEP6. Because neither EVEN nor ONLY 
is specified, the system does not execute this step if a preceding step abnormally terminates. 

//TB6T2 EXEC PGM=DUMPINT,COND=( (16/GEI) , (90,LE ,STEP1) ,ONLY) 
The system executes this step ONLY if two conditions are met: 

1 . A preceding job step abnormally terminated. 

2. No return code tests are satisfied. 

Therefore, the system executes this step only when all three of the following are true: 

• A preceding job step abnormally terminated. 

• The return codes from all preceding steps are 17 or greater. 

• The return code from STEPl is 89 or less. 

The system bypasses this step if any one of the following is true: 

• All preceding job steps terminated normally. 

• The return codes from all preceding steps are through 16. 

• The return code from STEPl is 90 or greater. 



//STEPl EXEC PGM=CINDY 

//STEP2 EXEC PGM=NEXT,C0ND=(4,EQ,STEP1) 

//STEPS EXEC PGM=LAST,C0ND=(,(8-,LT,STEP1) , (8,GT,STEP2) ) 



In this example, if STEPl returns a code of 4, STEP2 is bypassed. Before STEP3 is executed, 
the system performs the first return code test. If 8 is less than the return code from STEPl, 
STEP3 is bypassed; or, restated, if the STEPl return code is less than or equal to 8, STEP3 is 
executed. Because 4 is less than 8, STEP3 is executed. 

The system does not perform the second return code test because STEP2 was bypassed. 

//STP4 EXEC PROC=BILLING, COND. PAID=( (20, LT) , EVEN) , 

// COND. LATE=( 60, GT, FIND ) , 

// COND.BILL=( (20, GE) , (30,LT,CHGE) ) 

This statement calls cataloged or in-stream procedure BILLING. The statement specifies 
different return code tests for each of the procedure steps: PAID, LATE, and BILL. The 
system executes step PAID even if a preceding step abnormally terminates unless the 
accompanying return code is satisfied. 
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DPRTY Parameter 



Parameter Type: Keyword, optional 

Purpose: Use the DPRTY parameter to assign a dispatching priority to the address space for 
this job step. The system uses the dispatching priority to determine the order in which to 
execute tasks. 

Syntax: 



DPRTY [ .procstepname]=( [valuel] [ ,value2] ) 



• You can omit the parentheses if you code only valuel. 

• You must include the parentheses and code a comma before value2 if you code only 
value2. 



Subparameter Definition 



valuel 

Indicates whether this job step is to have the same or a different priority than the job. 
valuel is a number from through 15. 

JES2 determines the job priority from the following, in override order: 

1 . A JES2 /*PRIORITY statement. 

2. A PRTY parameter on the JOB statement. 

3. A value calculated from the accounting information on a JES2 /*JOBPARM 
statement or the JOB statement. 

4. An installation default specified at JES2 initialization. 

JES3 determines the job priority from the following, in override order: 

1 . A PRTY parameter on the JOB statement. If the specified priority is invalid, JES3 
issues an error message. 

2. An installation default specified at JES3 initialization. 

value2 

Specifies a number to be added to valuel to form the dispatching priority. value2 is a 
number from through 15. The system forms the internal dispatching priority as follows: 

dispatching priority = (valuel * 16) + value2 
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Defaults 

If you omit the DPRTY parameter, the system assigns the job step the automatic priority group 
(APG) priority. 

If you omit value 1 or it is equal to the APG priority, the system assigns the step the APG 
priority and ignores value2. In this case, the system obtains value2 from the installation 
performance specification (IPS) using the performance group associated with the job step. See 
SFL: Initialhaiion and Tuning for information on IPS. If value2 is not specified in the IPS, the 
system makes value2 equal to 6. 

Relationship to Other Control Statements 

For the step, the DPRTY parameter overrides the job's priority. 

On EXEC Statement that Calls a Procedure 

If this EXEC statement calls a cataloged or in-stream procedure, the DPRTY parameter 
overrides the DPRTY parameter on or is added to: 

• The EXEC statement named in the procstepname qualifier. The parameter applies only to 
the named procedure step. The EXEC statement can have as many DPRTY.procstepname 
parameters as the procedure has steps; each DPRTY parameter must specify a unique 
procstepname. 

• All EXEC statements in the procedure if procstepname is not coded. Then the parameter 
applies to this job step and to all steps in the called procedure. 



Examples of the DPRTY Parameter 



//BP2 EXEC PGM=FOUR,DPRTY=(13,9) 

The system uses the values in this DPRTY parameter to form a dispatching priority for this 
step. Because the numbers are '-elatively high, the dispatching priority will be high: 217. 

//STEP EXEC PR0C=CLEAN,DPRTY=(11,7) 

This EXEC statement calls a cataloged procedure named CLEAN, which has three steps. The 
DPRTY parameter applies to all three steps. The dispatching priority is 183. 

//STEP EXEC PROC=CLEAN,DPRTY.UP=(13,7) 

In this statement, the DPRTY parameter applies only to the procedure step UP. The 
dispatching priority for UP is 167. 
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DYNAMNBR Parameter 

Parameter Type: Keyword, optional 

Purpose: Use the DYNAMNBR parameter to tell the system to hold a number of resources in 
anticipation of reuse. Code DYNAMNBR instead of several DD statements with DYNAM 
parameters. 

Syntax: 



DYNAMNBR [ .procstepname] =n 



Subparameter Definition 



Specifies a value used to calculate the maximum number of data set allocations that the 
system can hold in anticipation of reuse, n is a decimal number from through the value: 
1635 minus the number of DD statements in the step. 

The number of resources that the system actually holds in anticipation of reuse equals n 
plus the number of DD statements in the step, including any DD statements in a 
cataloged or in-stream procedure called by the step. 



Defaults 



If no DYNAMNBR parameter is specified, the default is 0. If you code DYNAMNBR 
incorrectly, the system uses the default of and issues a JCL warning message. 

On EXEC Statement that Calls a Procedure 

If this EXEC statement calls a cataloged or in-stream procedure, the DYNAMNBR parameter 
overrides the DYNAMNBR parameter on or is added to: 

• The EXEC statement named in the procstepname quaUfier. The parameter applies only to 
the named procedure step. The EXEC statement can have as many 
DYNAMNBR.procstepname parameters as the procedure has steps; each DYNAMNBR 
parameter must specify a unique procstepname. 

• All EXEC statements in the procedure if procstepname is not coded. Then the parameter 
applies to all steps in the called procedure. 

Example of the DYNAMNBR Parameter 



//STEPl EXEC PR0C=ACCT,DYNAMNBR.CALC=12 

For the procedure step CALC, this statement specifies that the system should hold the 
following data set allocations for reuse: 12 plus the number of DD statements following this 
EXEC statement and the nimiber of DD statements in procedure ACCT. 
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PARM Parameter 



Use the PARM parameter to pass variable information to the processing program executed by 
this job step. To use the information, the processing program must contain instructions to 
retrieve the information. 

References.: For details on the format of the passed information and its retrieval, see 
Supervisor Services and Macro Instructions. 

Syntax: 



PARM[ .procstepname] =information 



Length: The entire information passed must not exceed 100 characters: 

• Including any commas, which are passed to the processing program. 

• Excluding any enclosing parentheses or apostrophes, which are not passed. 

For example, PARM = T1,123,MT5' is received by the program as P1,123,MT5. 

Commas: When the information consists of more than one expression, separate the 
expressions by commas and enclose the information in parentheses or apostrophes. For 
example, PARM = (P1,123,MT5) or PARM = T1,123,MT5'. 

Special Characters: When an expression contains special characters, enclose it in apostrophes 
and the information in parentheses or all the information in apostrophes. For example, 
PARM = (P50,'12 + 800 or PARM = T50,12 + 80'. 

Code each apostrophe and ampersand that is part of the information as two consecutive 
apostrophes or ampersands. For example, code 3462&5 as PARM = '3462&&5'. 

However, if an expression contains a symbolic parameter, code a single ampersand and do not 
enclose the expression in apostrophes, for example, PARM = &UNIT. 

Continuation onto Another Statement: Enclose the information in parentheses. End each 
statement with a comma after a complete expression. For example: 

//STEPl EXEC PGM=WORK,PARM= (DECK, LIST, •LINECNT=80' , 
// '12+80' ,NOMAP) 



Subparameter Definition 



information 

Consists of the information to be passed to the processing program. 
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On EXEC Statement that Calls a Procedure 



If this EXEC statement calls a cataloged or in-stream procedure, the FARM parameter 
overrides the FARM parameter on or is added to: 

• The EXEC statement named in the procstepname qualifier. The information appUes only 
to the named procedure step. The EXEC statement can have as many 

FARM. procstepname parameters as the procedure has steps; each FARM parameter must 
specify a unique procstepname. 

• The first EXEC statement in the procedure if procstepname is not coded; the system 
nullifies any FARM parameters on any following EXEC statements in the procedure. The 

information applies to only the first step in the called procedure. 

Examples of the PARM Parameter 



//RUN3 EXEC PGM=APG22,PARM='P1,123,P2=5' 

The system passes F1,123,F2 = 5 to the processing program named AFG22. 

// EXEC PROC=PROC81,PARM=MT5 

The system passes MT5 to the first step of the procedure named FR0C81. If FROC81 contains 
more steps and their EXEC statements contain PARM parameters, the system nullifies those 
FARM parameters. 

//STP6 EXEC PROC=ASMFCLG, PARM. LKED=( MAP, LET) 

The system passes MAF,LET to the procedure step named LKED in procedure ASMFCLG. If 
any other procedure steps in ASMFCLG contain a FARM parameter, those FARM parameters 
remain in effect. 

//RUN4 EXEC PGM=IFOX00,PARM=(NOOBJECT, 'LINECNT=50' , 
// DECK) 

The system passes NOOBJECT,LINECNT = 50,DECK to processing program IFOXOO. 
Because the FARM parameter is continued on a second statement, the information is enclosed 
in parentheses; notice that the continuation occurs after a comma following a complete 
expression. 
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PERFORM Parameter 



Parameter Type: Keyword, optional 

Purpose: Use the PERFORM parameter to specify the performance group for the job step. 
The installation-defined performance groups determine the rate at which associated steps have 
access to the processor, storage, and channels. 



Syntax: 



PERFORM [ .procstepname]=n 



Subparameter Definition 



Defaults 



Overrides 



Requests a performance group. The n is a number from 1 through 999 and must identify 
a performance group that has been defined by your installation. The specified 
performance group should be appropriate for your step type according to your 
installation's rules. 



If no PERFORM parameter is specified or if the specified PERFORM number fails validity 
checks, the system uses an installation default specified at initialization. If the installation did 
not specify a default, the system uses a built-in default: 

Default Use 

1 For non-TSO job steps 

2 For TSO sessions 



See SPL: Initialization and Tuning for details. 



A JOB statement PERFORM parameter appUes to all steps of the job and overrides any EXEC 
statement PERFORM parameters. 

Code EXEC statement PERFORM parameters when each job step is to execute in a different 
performance group. The system uses an EXEC PERFORM parameter only when no 
PERFORM parameter is on the JOB statement and only during the job step. 
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On EXEC Statement that Calls a Procedure 



If this EXEC statement calls a cataloged or in-stream procedure, the PERFORM parameter 
overrides the PERFORM parameter on or is added to: 

• The EXEC statement named in the procstepname qualifier. The parameter applies only to 
the named procedure step. The EXEC statement can have as many 
PERFORM.procstepname parameters as the procedure has steps; each PERFORM 
parameter must specify a unique procstepname. 

• All EXEC statements in the procedure if procstepname is not coded. Then the parameter 
applies to all steps in the called procedure. 

Example of the PERFORM Parameter 



//STEPA EXEC PGM= ADDER, PERFORM= 60 

This job step will be run in performance group 60 if it passes validity checks. The installation 
must have defined the significance of this performance group. 
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PGM Parameter 



Parameter Type: Positional, optional 

Purpose: Use the PGM parameter to name the program that the system is to execute. The 
specified program must be a member of a partitioned data set used as a system library, a 
private library, or a temporary Ubrary. 

Syntax: 



[program-name 
PGM= j * . stepname . ddname 

* . St epname.procstepname. ddname 

IJCLTEST 
JSTTEST 



The EXEC statement parameter field must begin with a PGM parameter or a PROC 
parameter. These two parameters must not appear on the same EXEC statement. 



Subparameter Definition 



program-name 

Specifies the member name or alias of the program to be executed. The program-name is 
1 through 8 alphanumeric or national characters; the first character must be alphabetic 
or national. 

Use this form of the parameter when the program resides in a system hbrary, such as 
SYSl.LINKLIB, or in a private Hbrary specified in the job by a JOBLIB DD statement 
or in the step by a STEPLIB DD statement. 

* .stepname.ddname 

Refers to a DD statement that defines, as a member of a partitioned data set, the 
program to be executed. Stepname identifies the EXEC statement of the earlier job step 
that contains the DD statement with ddname in its name field. 

Use this form of the parameter when a previous job step creates a temporary Ubrary to 
store a program until it is required. 

*.stepname.procstepname.ddname 

Refers to a DD statement that defines, as a member of a partitioned data set, the 
program to be executed. The DD statement is in a cataloged or in-stream procedure that 
is called by an earlier job step. Stepname identifies the EXEC statement of the calling job 
step; procstepname identifies the EXEC statement of the procedure step that contains the 
DD statement with ddname in its name field. 

Use this form of the parameter when a previous job step calls a procedure that creates a 
temporary Ubrary to store a program until it is required. 
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JCLTEST (JESSonly) 
JSTTEST (JES3only) 

Requests that the system scan the step's job control statements for syntax errors without 
executing the step or allocating devices. JCLTEST or JSTTEST provides for a step the 
same function as provided by the JOB statement TYPRUN = SCAN parameter for a job. 
See JESS Diagnosis for details. 

Note: JCLTEST and JSTTEST are supported only in JES3 systems. 
Examples of the PGM Parameter 



//JOBS JOB , BOB , MSGLEVEL= (2,0) 

//JOBLIB DD DSNAME=DEPT12.LIB4,DISP=( OLD, PASS) 

//STEPl EXEC PGM=USCAN 

These statements indicate that the system is to search the private Ubrary DEPT12.LIB4 for the 
member named USCAN, read the member into storage, and execute the member. 

//PROCESS JOB ,MARY,MSGCLASS=A 

//CREATE EXEC PGM=IEWL 

//SYSLMOD DD DSNAME=&&PARTDS (PROG) ,UNIT=3 350 ,DISP= (MOD , PASS ) , 

// SPACE= (1024, (50,20,1) ) 

//GO EXEC PGM=*. CREATE. SYSLMOD 

The EXEC statement named GO contains a backward reference to DD statement SYSLMOD, 
which defines a library created in the step named CREATE. Program PROG is a member of 
the partitioned data set &&PARTDS, which is a temporary data set. Step GO executes 
program PROG. The data set &&PARTDS is deleted at the end of the job. 

//JOBC JOB ,JOHN,MSGCLASS=H 

//STEP2 EXEC PGM=UPDT 

//DDA DD DSNAME=SYS1.LINKLIB(P40) ,DISP=OLD 

//STEPS EXEC PGM=*.STEP2.DDA 

The EXEC statement named STEPS contains a backward reference to DD statement DDA, 
which defines system library SYSl.LINKLIB. Program P40 is a member of SYSl.LINKLIB; 
STEP3 executes program P40. 
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PROC and Procedure Name Parameters 

Parameter Type: Positional, optional 

Purpose: Use the PROC parameter to specify that the system is to call and execute a cataloged 
or in-stream procedure. 

Syntax: 



PROC=procedure-name 
Iprocedure-name 



The EXEC statement parameter field must begin with a PGM parameter or a PROC 
parameter. These two parameters must not appear on the same EXEC statement. 

You can omit PROC = and code only the procedure-name. 



Subparameter Definition 

procedure-name 

Identifies the procedure to be called and executed: 

• The member name or alias of a cataloged procedure. 

• The name on the PROC statement that begins an in-stream procedure. The in-stream 
procedure must appear eariier in this job. 

The procedure-name is 1 through 8 alphanumeric or national characters; the first 
character must be alphabetic or national. 

Effect of PROC Parameter on Other Parameters and Following Statements 

Because this EXEC statement calls a cataloged or in-stream procedure, the other parameters on 
the statement are added to or override corresponding parameters on the EXEC statements in 
the called procedure. See the descriptions of the other parameters for details of their effects. 

Any DD statements following this EXEC statement are added to the procedure, or override or 
nulhfy corresponding DD statements in the procedure. 



Examples of the PROC Parameter 



//SP3 EXEC PROC=PAYWKRS 

This statement calls the cataloged or in-stream procedure named PAYWKRS. 

//BK EXEC OPERATE 

This statement calls the cataloged or in-stream procedure named OPERATE. 
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RD Parameter 



Parameter Type: Keyword, optional 

Purpose: Use the RD (restart definition) parameter to: 

• Specify that the operator is to perform automatic step restart if the job fails. 

• Suppress, partially or totally, the action of the assembler language CHKPT macro 
instruction or the DD statement CHKPT parameter. 

The system can perform automatic restart only if all of the following are true: 

• The JOB or EXEC statement contains RD = R or RD = RNC. 

• The step to be restarted returned a completion code that indicated no error in the step. 

• The operator authorizes a restart. 

• The job has a job journal. 

A job journal is a sequential data set that contains job-related control blocks needed for restart. 
For JES2, specify a job journal by one of the following: 

• An installation option during JES2 initiaUzation to specify a checkpoint data set. 

• RESTART parameter on the JOB statement. 

• RD = R or RD = RNC on either the JOB statement or any one EXEC statement in the job. 

For JES3, specify a job journal in one of the following: 

• An installation option during JES3 initialization. 

• RD = R or RD = RNC on either the JOB statement or any one EXEC statement in the job. 

• JOURNAL = YES on a JES3 //*MAIN statement in the job. 

References: For detailed information on deferred checkpoint restart, see Checkpoint! Restart 
User's Guide. 

Syntax: 
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Subparameter Definition 



R (Restart, Checkpoints Allowed) 

Indicates that the operator is to perform automatic step restart if the job step fails. 

RD = R does not suppress checkpoint restarts: 

• If the processing program executed in a job step does not include a CHKPT macro 
instruction, RD — R allows the system to restart execution at the beginning of the 
abnormally terminated step. 

• If the program includes a CHKPT macro instruction, RD = R allows the system to 
restart execution at the beginning of the step, if the step abnormally terminates before 
the CHKPT macro instruction is executed. 

• If the step abnormally terminates after the CHKPT macro instruction is executed, 
only checkpoint restart can occur. If you cancel the affects of the CHKPT macro 
instruction before the system performs a checkpoint restart, the request for automatic 
step restart is again in effect. 

RNC (Restart, No Checkpoints) 

Indicates that the operator is to perform automatic step restart if the job step fails. 

RD = RNC suppresses automatic and deferred checkpoint restarts. It suppresses: 



• Any CHKPT macro instruction in the processing program: That is, the 
not to perform an automatic checkpoint restart, and the system is not to perform a 
deferred checkpoint restart if the job is resubmitted. 

• The DD statement CHKPT parameter. 

• The checkpoint at end-of-volume (EOV) faciUty. 

NR (No Automatic Restart, Checkpoints Allowed) 

Indicates that the operator is not to perform automatic step restart if the job fails. 

RD = NR suppresses automatic checkpoint restart but permits deferred checkpoint 
restarts. It permits: 

• A CHKPT macro instruction to establish a checkpoint. 

• The job to be resubmitted for restart at the checkpoint. On the JOB statement when 
resubmitting the job, specify the checkpoint in the RESTART parameter. 

If you code RD = NR and the system fails, RD = NR does not prevent the job from 
restarting. 
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EXEC: RD 



NC (No Automatic Restart, No Checkpoints) 

Indicates that the operator is not to perform automatic step restart if the job step fails. 

RD = NC suppresses automatic and deferred checkpoint restarts. It suppresses: 

• Any CHKPT macro instruction in the processing program. 

• The DD statement CHKPT parameter. 

• The checkpoint at EOV faciUty. 



If no RD parameter is specified, the terminated job step is eUgible for automatic 
checkpoint/restart, if its program requested checkpoints with a CHKPT macro instruction. 



Overrides 



• A JOB statement RD parameter applies to all steps of the job and overrides any EXEC 
statement RD parameters. 

When no RD parameter is on the JOB statement, the system uses an EXEC statement RD 
parameter, but only during the job step. Code EXEC statement RD parameters when you 
want to specify different restart types for each job step. 

• A request by a CHKPT macro instruction for an automatic checkpoint restart overrides a 
request by a JOB or EXEC statement RD = R parameter for automatic step restart. 

Relationship to Other Control Statements 

Code RD = NC or RD = RNC to suppress the action of the DD statement CHKPT parameter. 

On EXEC Statement that Calls a Procedure 

If the EXEC statement calls a cataloged or in-stream procedure, the RD parameter is added to 
or overrides the RD parameter on; 

• The EXEC statement named in the procstepname quahfier. The information applies only 
to the named procedure step. The EXEC statement can have as many RD.procstepname 
parameters as the procedure has steps; each RD parameter must specify a unique 
procstepname. 

• All EXEC statements in the procedure if procstepname is not coded. Then the parameter 
applies to all steps in the called procedure. 
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Examples of the RD Parameter 



//STEPl EXEC PGM=GIIM,RD=R 

RD = R specifies that the operator is to perform automatic step restart if the job step fails. 

//NEST EXEC PGM=T18,RD=RNC 

RD = RNC specifies that, if the step fails, the operator is to perform automatic step restart. 
RD = RNC suppresses automatic and deferred checkpoint restarts. 

//CARD EXEC PGM=WTE,RD=NR 

RD = NR specifies that the operator is not to perform automatic step restart or automatic 
checkpoint restart. However, a CHKPT macro instruction can establish checkpoints to be used 
later for a deferred restart. 

//STP4 EXEC PROC=BILLING,RD.PAID=NC,RD.BILL=NR 

This statement calls a cataloged or in-stream procedure BILLING. The statement specifies 
different restart requests for each of the procedure steps: PAID and BILL. 
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REGION Parameter 



Parameter Type: Keyword, optional 

Purpose: Use the REGION parameter to specify the amount of space that the step requires. 

The specified or default region size sets an upper boundary to limit region size for 
variable-length GETMAINs. The system uses the upper boundary for variable-length 
GETMAINs as long as the region still has available at least the minimum amount of storage 
requested. 

In addition, the IBM- or installation-supplied routine lEFUSI uses the region size to establish a 
second limiting value. The system uses this second value to limit: 

• Fixed-length GETMAINs. 

• Variable-length GETMAINs when the space remaining in the region is less than the 
requested minimum. 

When the minimum requested length for variable-length GETMAINs or the amount requested 
for a fixed-length GETMAIN exceeds this second value, the job step abnormally terminates. 

REGION = OK or REGION = 0M gives the job step all the storage available in the private area, 
that is, from the top of the system region to the bottom of the common service area (CSA). 
The resulting size of the region is unpredictable. 

References: For more information on the region size, see SPL: System Modifications. 

Syntax: 



REGION [ .procstepname] = 


valueK 
valueM 





Subparameter Definition 



valueK 

Specifies the required storage in kilobytes (1 kilobyte = 1024 bytes). The value is 1 
through 7 decimal numbers, from 1 through 2096128. Code an even number. For 
example, REGION = 66K. If you code an odd number, the system treats it as the next 
highest even number. 

valueM 

Specifies the required storage in megabytes (1 megabyte = 1024 kilobytes). The value is 
1 through 4 decimal numbers, from 1 through 2047. Code either an even or odd number. 
For example, REGION = 3M. 
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Defaults 



If no REGION parameter is specified, the system uses an installation default specified at JES 
initialization. 



Overrides 



A JOB statement REGION parameter applies to all steps of the job and overrides any EXEC 
statement REGION parameters. 

When no REGION parameter is on the JOB statement, the system uses an EXEC statement 
REGION parameter, but only during the job step. Code EXEC statement REGION 
parameters when you want to specify a different region size for each job step. 

Relationship to the EXEC ADDRSPC Parameter 

When ADDRSPC == REAL: Code a REGION parameter to specify how much real storage the 
job needs. If you omit the REGION parameter, the system uses the default. 

When ADDRSPC= VIRT or ADDRSPC is Omitted: Code a REGION parameter to specify 
how much virtual storage the job needs. If you omit the REGION parameter, the system uses 
the default. 

If the EXEC statement calls a cataloged or in-stream procedure, the REGION parameter is 
added to or overrides the REGION parameter on: 

• The EXEC statement named in the procstepname qualifier. The information applies only 
to the named procedure step. The EXEC statement can have as many 

REGION, procstepname parameters as the procedure has steps; each REGION parameter 
must specify a unique procstepname. 

# All EXEC statements in the procedure if procstepname is not coded. Then the parameter 
applies to all steps in the called procedure. 

Examples of the REGION Parameter 



//MKBOYLE EXEC PROC=A,ADDRSPC=REAL,REGION=40K 

The system assigns 40K bytes of real storage to this job step. 

//STP6 EXEC PGM=CONT,REGION=120K 

The system assigns a region of 120K bytes. When the ADDRSPC parameter is not specified, 
the system defaults to ADDRSPC = VIRT. 
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TIME Parameter 



Parameter Type: Keyword, optional 

Purpose: Use the TIME parameter to specify the maximum length of time that a job step is to 
use the processor and to find out through messages how much processor time the step used. 

A step that exceeds its allotted time abnormally terminates and causes termination of the job, 
unless a user exit routine extends the time for the job. The exit routine is established through 
System Management Facilities (SMF). 

References: See SPL: System Management Facilities (SMF). 

Syntax: 



TIME [ .procstepname] = 



( [minutes] [ , seconds] ) 
1440 



You can omit the parentheses if you code only 1440 or the processor time in minutes. 

If you omit the seconds, do not code a null subparameter. For example, TIME = (60,) is 
invalid. 



Subparameter Definition 



minutes 

Specifies the maximum number of minutes the step can use the processor. The minutes 
must be a number from 1 through 1439. 

Code TIME = on the EXEC statement to indicate that the step is to use the unexpired 
time from the previous step. If this step exceeds that unexpired time, it abnormally 
terminates. 

seconds 

Specifies the maximum number of seconds that the step can use the processor, in addition 
to any minutes that are specified. The seconds must be a number from 1 through 59. 



1440 



Indicates that the step can use the processor for an unlimited amount of time; 1440 
literally means 24 hours. Code TIME = 1440 for the following reasons: 

• To obtain job step accounting information. 

• To specify that the system is to allow this step to remain in a continuous wait state 
for more than the installation time limit, which is established through SMF. 
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Defaults 



If no TIME parameter is specified, JES uses an installation default specified at initialization. 
If 1440 is not specified, SMF uses its current job wait time limit. 



Overrides 



For a JOB statement TIME parameter other than TIME = 1440, the system sets the time limit 
for each step to: 

• The step time Umit specified on the EXEC statement TIME parameter. 

• If no EXEC TIME parameter was specified, (1) the default time limit or (2) the job time 
remaining after execution of previous steps, whichever is smaller. 

On EXEC Statement that Calls a Procedure 

If the EXEC statement calls a cataloged or in-stream procedure, the TIME parameter is added 
to or overrides the TIME parameter on: 

• The EXEC statement named in the procstepname qualifier. The information appUes only 
to the named procedure step. The EXEC statement can have as many TIME.procstepname 
parameters as the procedure has steps; each TIME parameter must specify a unique 
procstepname. 

If procstepname is not coded, the TIME parameter applies to the entire procedure and nullifies 
any TIME parameters on EXEC statements in the procedure. 

Time Handling 

How the System Converts the Time Value: The job time limit or the time remaining after 
execution of previous steps in a job is converted by the system to seconds and then rounded to 
the nearest unit, where 1 umt= 1,048576 seconds. Thus a step can begin execution with up to 
one-half unit more or one-half unit less time than expected. If the time remaining for the job is 
less than one-half unit, a step will begin execution with zero time, resulting in an abnormal 
termination. 

Time Checking: Because the system checks the processor time-used field about every 10.5 
seconds, the actual time that a job uses the processor can exceed the specified TIME value by 
up to 10.5 seconds. For example, the system checks the job's time-used field and finds 0.5 
seconds remaining. Because the system does not again check the job's time-used field for about 
10.5 seconds, the job can execute for an additional 10.5 seconds and thus exceed the coded 
TIME value by 10 seconds. 
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Examples of the TIME Parameter 



//STEPl EXEC PGM=GRYS,TIME=(12,10) 

This statement specifies that the maximum amount of time the step can use the processor is 12 
minutes, 10 seconds. 

//FOUR EXEC PGM=JPLUS,TIME=( ,30) 

This statement specifies that the maximum amount of time the step can use the processor is 30 
seconds. 

//INT EXEC PGM=CALC,TIME=5 

This statement specifies that the maximum amount of time the step can use the processor is 5 
minutes, 

//LONG EXEC PGM=INVANL,TIME=1440 

This statement specifies that the step can have unlimited use of the processor. Therefore, the 
step can use the processor and can remain in a wait state for an unspecified period of time, if 
not restricted by the JOB statement TIME parameter. 

//STP4 EXEC PROC=BILLING,TIME.PAID=(45,30) ,TIME.BILL=(112,59) 

This statement calls cataloged or in-stream procedure BILLING. The statement specifies 
different time Umits for each of the procedure steps: PAID and BILL. 

For examples of TIME coded on both the JOB and EXEC statements, see "Examples of the 
TIME Parameter on JOB and EXEC Statements" on page 15-39. 
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JOB 



Chapter 15. JOB Statement 



Purpose: Use the JOB statement to mark the beginning of a job and to tell the system how to 
process the job. Also, when jobs are stacked in the input stream, the JOB statement marks the 
end of the preceding job. 

The parameters you can specify for job processing are arranged alphabetically in the following 
pages. 

References: For information about the JES initialization parameters that provide installation 
defaults, see SPL: JES2 Initialization and Tuning and SPL: JES3 Initialization and Tuning. 

Syntax: 



//jobname JOB positional-parameters [ ,keYword-parameter] .. . [comments] 
//jobname JOB 



The JOB statement consists of the characters // in columns 1 and 2 and four fields: name, 
operation (JOB), parameter, and comments. Do not code comments if the parameter field is 
blank. 

A JOB statement is required for each job. 



Name Field 

Code a jobname on every JOB statement, as follows: 

• Each jobname must be unique. 

• The jobname must begin in column 3. 

• The jobname is 1 through 8 alphanumeric or national characters. If your system uses 
ANSI tapes, the jobname must contain only alphanumeric characters; it must not contain 
national characters. 

• The first character must be alphabetic or national. 

• The jobname must be followed by at least one blank. 
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Operation Field 



The operation field consists of the characters JOB and must be preceded and followed by at 
least one blank. It can begin in any column. 



Parameter Field 



A JOB statement has two kinds of parameters: positional and keyword. All parameters are 
optional; however, your installation may require the accounting information parameter and the 
programmer's name parameter. 

Positional Parameters: A JOB statement can contain two positional parameters. They must 
precede all keyword parameters. You must code the accounting parameter first, followed by 
the programmer's name parameter. 



POSITIONAL PARAMETERS 


VALUES 


PURPOSE 


([account-number][,accoun ting-information] . . .) 
See page 15-5 


account-number,accounting-information: 
up to 142 characters 


specifies an account number and 
other accounting information, for- 
matted as required by the installation. 
This parameter may be required by 
the installation. 


programmer's-name 
See page 15-25 


programmer's name: 1 - 20 characters 


Identifies the owner of the job. 
This parameter may be required by 
the installation. 



Keyword Parameters: A JOB statement can contain the following keyword parameters. You 
can code any of the keyword parameters in any order in the parameter field after the positional 
parameters. 



KEYWORD PARAMETERS 


VALUES 


PURPOSE 


ADDRSPC = 

See page 15-9 


VIRT 
REAL 




VIRT: virtual (pageable) storage 
REAL: real (nonpageable) storage 


Indicates the type of storage required 
for the job. 


CLASS =jobclass 
See page 15-11 


jobclass: A - Z, - 9 


Assigns the job to a job class. 


COND = ((code,operator)[,(code,operator)]...) 
See page 15-13 


code: - 4095 

operator: GT Code from 

GE chart on 

EQ page 15-14 

NE 

LT 

LE 


Specifies the return code tests used to 
determine whether a job will continue 
processing or be terminated. 
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KEYWORD PARAMETERS 


VALUES 


PURPOSE 


GROUP = group-name 
Seepage 15-15 


group-name: 1 - 8 alphanumeric or 
national characters 


Identifies a group to which a 
RACF-defined user is to be 
connected. 


MSGCLASS = class 

Seepage 15-17 


class: A - Z, - 9 


Assigns the job log to an output class, 


MSGLEVEL = ([statements][,messages]) 
See page 15-19 


statements: 

Only JOB statement 

1 All JCL and procedure statements 

2 Only JCL statements 
messages: 

Only JCL messages 

1 JCL, JES, and operator messages 


Indicates the job control information 
to be printed in the job log. 


NOTIFY = userid 
Seepage 15-21 


userid: 1 - 7 alphanumeric characters 


Requests that the system send a 
message to a TSO userid when this 
background job completes. 


PASSWORD = (password[,new-password]) 
See page 15-22 


password or new-password: 1 - 8 
alphanumeric or national characters 


Identifies the current RACF 
password or specifies a new RACF 
password. 


PERFORM = n 

Seepage 15-24 


n: 1 - 999 


Specifies the job's performance group, 
which determines the rate at which 
the job has access to the processor, 
storage, and channels. 


PRTY= priority 

See page 15-27 


priority (JES2): 0-15 
priority (JES3): - 14 


JES2: Assigns the job's queue 
selection priority. 

JES3: Assigns the job's initiation or 
selection priority in its job class. 


RD = 

See paj 


R 

RNC 

NR 

NC 

?e 15-2 


9 


R: restart, checkpoints allowed 
RNC: restart, no checkpoints 
NR: no restart, checkpoints allowed 
NC: no restart, no checkpoints 


Indicates whether the operator should 
perform automatic step restart, if the 
job fails, and controls whether 
checkpoints are written for CHKPT 
macros or DD statement CHKPT 
parameters. 


REGION = 

Seepage 15-3 


valueK 
valueM 

2 




valueK: even number, 1-7 digits 

from 1 - 2096128 
valueM: even or odd number, 1-4 digits 

from 1 - 2047 


Specifies the amount of space in 
kilobytes or megabytes required 
by the job. 
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KEYWORD PARAMETERS 



VALUES 



PURPOSE 



RESTART = 



stepname 
stepname.procstepname 



[jCheckid] 



Seepage 15-34 



*: at first step 
stepname: at named step 
procstepname: step is in named procedure 
checkid: at clieckpoint in first or named 
step 



Specifies restart of a job at the 
beginning of a step or from a 
checkpoint within a step. 



Tlf^E — J ([uiiuutci*][,secunus]) 
[ 1440 

See page 15-37 



minutes: i - 1439 
seconds: 1-59 



Specifies the maximum time the job is 
to use the processor and requests 
messages giving the time used. 



TYPRUN = 



COPY 
HOLD 
JCLHOLD 
SCAN 



See page 15-40 



COPY: copies job stream to sysout data 

set (JES2 only) 
HOLD: holds job (JES2 only) 
JCLHOLD: holds job before JCL 

processing (JES2 only) 
SCAN: scans JCL for syntax errors 



Requests special job processing. 



USER = userid 
See page 15-42 



userid: 1 - 7 alphanumeric or national 
characters 



Identifies the job's owner to RACE, 
SRM, and other system components. 



Comments Field 



The comments field follows the parameter field after at least one intervening blank. If you do 
not code any parameters on a JOB statement, do not code any comments. 



Location in the JCL 



A JOB statement must be the first statement in each job. JOB statements never appear in 
cataloged or in-stream procedures. 



Examples of JOB Statements 



//ALPHA 

//LOS 

//MART 

//TRY8 

//RACFl 

//RUNl 

// 

// 



JOB 
JOB 
JOB 
JOB 
JOB 
JOB 



843 , LINLEE , CLASS=F ,MSGCLASS=A ,MSGLEVEL= (1,1) 

,'J M BUSKIRK' ,TIME=( 4,30) ,MSGCLASS=H,MSGLEVEL=( 2,0) 

1863,RESTART=STEP4 THIS IS THE THIRD JOB STATEMENT. 



' D83 , 12 3 ' , USER=RACO 1 , GR0UP=A2 7 , PASSWORD=XYY 
'D8306P,D83,B1062J12,S=C' , 'JUDY PERLMAN ' ,MSGCLASS=R, 

MSGLEVEL=(1,1) ,CLASS=3 ,N0TIFY=D83JCS1, 

C0ND=(8,LT) 
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JOB: Accounting Information 



Accounting Information Parameter 

Parameter Type: Positional, required (according to installation procedures) 

Purpose: Use the accounting information parameter to enter an account number and any other 
accounting information that your installation requires. 

References: For more information on how to add accounting routines, see SPL: System 
Management Facilities. 



Syntax: 



( [account -number] [ , accounting- information] . . . ) 



Location: Code the accounting information parameter first in the parameter field. 

Omission: If you omit the accounting information parameter but you are coding a 
programmer's name parameter, code a comma to indicate the omitted parameter. If you 
omit both positional parameters, do not code any commas before the first keyword 
parameter. 

Length: The entire accounting information parameter must not exceed 142 characters: 

• Including any commas, which are considered part of the information. 

• Excluding any enclosing parentheses, which are not considered part of the information. 

IMultiple Subparameters: When the accounting information parameter consists of more than 
one subparameter, separate the subparameters by commas and enclose the parameter in 
parentheses or apostrophes. For example, (5438,GROUP6) or '5438,GROUP6'. If you use 
apostrophes, all information inside the apostrophes is considered one field. 

Special Characters: When a subparameter contains special characters, other than hyphens, 
enclose it in apostrophes and the entire parameter in parentheses or enclose all of the 
parameter in apostrophes. For example, (12A75,'DEPT/D58',706) or 
'12A75,DEPT/D58,706'. 

Code each apostrophe or ampersand that is part of the accounting information as two 
consecutive apostrophes or ampersands. For example, code DEPT'D58 as 
(12A75,'DEPT"D58',706) or '12A75,DEPT"D58,706'. Code 34&251 as '34&&25r. 

Continuation onto Another Statement: Enclose the accounting information parameter in 
parentheses. End each statement with a comma after a complete subparameter. For 
example: 

//JOBl JOB ( 12A75 , ' DEPT/D58 ' , 
// 706) 
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JOB: Accounting Information 

Subparameter Definition 

account-number 

Specifies an accounting niunber, as defined by the installation. 

accounting-information 

Specifies more information, as defined by the installation. For example, your department 
and room numbers. 

Relationship to Other Control Statements 

If you are to provide accounting information for an individual step within a job, code an 
ACCT parameter on the EXEC statement for that step. 

J£S2 Accounting Information Format 

Except for the first subparameter, the JES2 accounting information shown in the syntax can, 
alternatively, appear on the JES2 /* JOBPARM statement. If you code the accounting 
information parameter in the JES2 format, JES2 can interpret and use it. 

References: For a discussion of the JES2 scan of the accounting information parameter, see 
SPL: JES2 Initialization and Tuning. 

Syntax: 

I ^ ^ ^ ^ 

(pano, room, time, lines, cards, forms , copies, log, linect) 



Code a comma in place of each omitted subparameter when other subparameters follow. 



Subparameter Definition 

pano 

Specifies the programmer's accounting number, pano is 1 through 4 alphanumeric 
characters. 

room 

Specifies the programmer's room number, room is 1 through 4 alphanumeric characters. 

time 

Specifies the estimated execution time in minutes, time is 1 through 4 decimal numbers. 
For example, code 30 for 30 minutes. If you omit a time subparameter and a TIME 
parameter on the JES2 /* JOBPARM statement, JES2 uses an installation default specified 
at initialization. If job execution exceeds the time, JES2 sends a message to the operator. 

Unes 

Specifies the estimated line count, in thousands of lines, from this job's sysout data sets, 
lines is 1 through 4 decimal numbers. For example, code 5 for 5000 lines. If you omit 
lines, JES2 uses an installation default specified at initiahzation. 
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JOB: Accounting Information 



cards 

Specifies the estimated number of cards JES2 is to punch fi^om this job's sysout data sets, 
cards is 1 through 4 decimal numbers. If you omit cards, JES2 uses an installation 
default specified at initialization. 

forms 

Specifies the forms that JES2 is to use for printing this job's sysout data sets, forms is I 
through 4 alphanumeric characters. For example, code 5 for 5-part forms. If you omit 
forms, JES2 uses an installation default specified at initialization. 

copies 

Specifies the number of times JES2 is to print and/or punch this job's sysout data sets, 
copies is 1 through 3 decimal numbers not exceeding an installation-specified limit. The 
maximum is 255. For example, code 2 for two copies. If you omit copies, JES2 assumes 
one copy. 

The copies subparameter is ignored and only one copy is produced if the output class for 
the job log, as specified in the JOB MSGCLASS parameter, or the output class of any of 
the job's system output data sets is a held class. 

log 

Specifies whether or not JES2 is to print the job log. Code N to request no job log. If 
you code any other character or omit this subparameter, JES2 prints the job log. If your 
installation specified NOLOG for this job's class during JES2 initialization, JES2 will not 
print a job log. 

linect 

Specifies the number of lines JES2 is to print per page for this job's sysout data sets, 
linect is 1 through 3 decimal numbers. When you send a data set across a network, linect 
cannot exceed 254. When you print the data set locally, linect cannot exceed 255. If you 
omit linect, JES2 uses an installation default specified at initialization. If you code a zero, 
JES2 does not eject to a new page when the number of lines exceeds the installation 
default. 

Invalid Subparameters: Your installation can initialize JES2 to do one of the following if the 
accounting information contains subparameters that are invahd to JES2: 

• Ignore the invalid subparameters. 

• Terminate the job. In this case, JES2 requires the first two subparameters: pano and room. 

Overrides: A parameter on any of the following statements overrides an equivalent accounting 
information subparameter on the JOB statement: 

• JES2 /*JOBPARM statement 

• JES2 /*OUTPUT statement 

• OUTPUT JCL statement 

• DD statement 
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Examples of the Accounting Information Parameter 



//JOB43 JOB D548-8686 



//JOB44 JOB (D548-8686, '12/8/85' ,PGMBIN) 

Because this statement contains an account-number plus additional accounting-information, 
parentheses are required. 

//JOB45 JOB (CFH1,2G14,15, , , ,2) 

This statement shows a JES2 accounting information parameter: programmer's accounting 
number, CFHl; room number, 2G14; estimated job time, 15 minutes; and copies, 2. 
Parentheses are required. Standard values are assumed for the other JES2 subparameters. 
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JOB: ADDRSPC 



ADDRSPC Parameter 



Parameter Type: Keyword, optional 

Purpose: Use the ADDRSPC parameter to indicate to the system that the job requires virtual 
storage (pageable) or real storage (nonpageable). 

Syntax: 




Subparameter Definition 
VIRT 



Requests virtual storage. The system can page the job. 

REAL 

Requests real storage. The system cannot page the job and must place each step of the 
job in real storage. 



If no ADDRSPC parameter is specified, the default is VIRT. 



Defaults 



Overrides 

The JOB statement ADDRSPC parameter applies to all steps of the job and overrides any 
EXEC statement ADDRSPC parameters. 

Code EXEC statement ADDRSPC parameters when each job step requires different types of 
storage. The system uses an EXEC statement ADDRSPC parameter only when no ADDRSPC 
parameter is on the JOB statement and only during the job step. 

Relationship to the JOB REGION Parameter 

When ADDRSPC =^ REAL: Code a REGION parameter to specify how much real storage the 
job needs. If you omit the REGION parameter, the system uses an installation default 
specified at JES initialization. 

When ADDRSPC '^ VIRT or ADDRSPC is Omitted: Code a REGION parameter to specify 
how much virtual storage the job needs. If you omit the REGION parameter, the system uses 
an installation default specified at JES initialization. 
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JOB: ADDRSPC 

Examples of the ADDRSPC Parameter 



//PEH JOB , BAKER, ADDRSPC=VIRT 

The ADDRSPC parameter requests virtual (pageable) storage. The space available to the job is 
the installation-specified default. 

//DEB JOB ,ERIC,ADDRSPC=REAL,REGION=100K 

The ADDRSPC parameter requests real (nonpageable) storage. The REGION parameter 
specifies lOOK of storage for the job. 
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JOB: CLASS 



CLASS Parameter 



Parameter Type: Keyword, optional 

Purpose: Use the CLASS parameter to assign the job to a class. The class you should request 
depends on the characteristics of the job and your installation's rules for assigning classes. 

In a JES2 system, the assigned job class can affect whether or how a job is executed. A job 
class can be defined during JES2 initialization as: 

• Held. The system holds any job assigned to this class until the operator releases it. 

• To be copied only. The system copies the input stream for the job directly to a sysout data 
set and schedules the sysout data set for output processing. The system does not execute 
the job or allocate devices. 

• To be scanned for job control statement syntax errors. The system does not execute the job 
or allocate devices. 



Syntax: 



CLASS=jobclass 



Subparameter Definition 



Defaults 



Overrides 



jobclass 

Identifies the class for the job. The jobclass is one character, A through Z or through 9, 
and must be a valid class specified at JES initiahzation. 



If you do not specify a class, JES uses the installation default specified at initialization, as 
follows: 

• In a JES2 system, the default is based on the source of the job: The system makes the job's 
class the same as the installation-specified default class for the particular card reader, work 
station, or time-sharing user that submitted the job. 

• In a JES3 system, the default is an installation-defined standard default class. 



A JES3 //*MAIN statement CLASS parameter overrides a JOB statement CLASS parameter. 
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Relationship to Other Control Statements 

In JES3 systems, you can also code a CLASS parameter on a JES3 //*MAIN statement. 

Example of the CLASS Parameter 

//SETUP JOB 1249, SMITH, CLASS=M 
This statement assigns the job to class M. 
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JOB: COND 



COND Parameter 



Parameter Type: Keyword, optional 

Purpose: Use the COND parameter to specify the return code tests the system uses to 
determine whether a job will continue processing. Before each job step is executed, the system 
performs the COND parameter tests against the return codes from completed job steps. If none 
of these tests is satisfied, the system executes the job step; if any test is satisfied, the system 
bypasses all remaining job steps and terminates the job. 

The tests are made against return codes from the current execution of the job. A step bypassed 
because of an EXEC statement COND parameter does not produce a return code. 

Bypassing a step because of a return code test is not the same as abnormally terminating the 
step. The system abnormally terminates a step following an error so serious that it prevents 
successful execution. In contrast, bypassing of a step is merely its omission. 

Note: In both JES2 and JES3 systems, a JOB COND parameter determines if steps are 
executed or bypassed. However, JES3 processes all jobs as though each step will execute; 
therefore, JES3 allocates devices for steps that are bypassed. 

Syntax: 



COND= ( code , operator ) 

COND= { ( code , operator ) [ , ( code , operator )]...) 



• One return code test is: (code,operator) 

• You can omit the outer parentheses if you code only one return code test. 

• Specify up to eight return code tests for a job. 



Subparameter Defilnitioii 
code 



Specifies a number that the system compares to the return code from each job step, code 
is a decimal number from through 4095. 

Note: Specifying a decimal number greater than 4095 could result in invahd return code 
testing or invaUd return codes in messages. 

operator 

Specifies the type of comparison to be made to the return code. If the specified test is 
true, the system bypasses all remaining job steps. Use the chart on this page to select the 
correct operator. Operators and their meanings are: 

Operator Meaning 



GT 


Greater than 


GE 


Greater than or equal to 


EQ 


Equal to 


NE 


Not equal to 


LT 


Less than 


LE 


Less than or equal to 
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Overrides 



If you code the COND parameter on the JOB statement and on one or more of the job's EXEC 
statements, and if a return code test on the JOB statement is satisfied, the job terminates. In 
this case, the system ignores any EXEC statement COND parameters. 

If the tests on the JOB statement are not satisfied, the system then performs the return code 
tests on the EXEC statement. If an EXEC return code test is satisfied, the step is bypassed. 



Summary of COND Parameters 



Test in COND Parameter 


Return Code (RC) from Just Completed Step 


Continue Job 


Terminate Job 


COND=^(code,GT) 
COND = (code,GE) 
COND = (code,EQ) 
COND = (code,LT) 
COND = (code,LE) 
COND'=(code,NE) 


RC > code 
RC > code 
RC -1 = code 
RC < code 
RC < code 
RC = code 


RC < code 
RC ^ code 
RC = code 
RC > code 
RC >: code 
RC -1 = code 



Figure 15-1. Continuation or Termination of the Job Based on COND Parameter 



Examples of the COND Parameter 



//TYPE JOB (611,402) .BOURNE, C0ND=(7,LT) 

The COND parameter specifies that if 7 is less than the return code, the system terminates the 
job. Any return code less than or equal to 7 allows the job to continue. 

//TEST JOB 501,BAXTER,COND=((20,GE) , (30,LT) ) 

The COND parameter specifies that if 20 is greater than or equal to the return code or if 30 is 
less than the return code, the system terminates the job. Any code of 21 through 30 allows the 
job to continue. 
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JOB: GROUP 



GROUP Parameter 



Parameter Type: Keyword, optional 

Purpose: Use the GROUP parameter to specify a RACF-defined group to which a 
RACF-defined user is to be connected. RACF places each RACF-defined user in a default 
group; the GROUP parameter is needed only to specify a group other than a user's default 
group. 

If the installation contains the feature for propagation of the user and group identification, the 
USER, the PASSWORD, and, optionally, the GROUP parameters are required on JOB 
statements only for the following: 

• Batch jobs submitted through an input stream, such as a card reader, (1) if the job requires 
access to RACF-protected resources or (2) if the installation requires that all jobs have 
RACF identification. 

• Jobs submitted by one TSO user for another user. In this case, the JOB statement must 
specify the other user's userid and password. The group id is optional. 

• Jobs that execute at another network node that uses RACF protection. 

Otherwise, the USER, PASSWORD, and GROUP parameters can be omitted from JOB 
statements. RACF uses the userid, password, and default group id of the submitting TSO user 
or job. 

References: For more information on RACF-protected facilities, see Resource Access Control 
Facility (RACF) General Information Manual 

Syntax: 



GROUP = group -name 



Subparameter Definition 



Defaults 



group-name 

Identifies the group with which the system is to associate the user, group-name is 1 
through 8 alphanumeric or national characters. The first character must be alphabetic or 
national. 



If you do not code the GROUP parameter, but do code the USER and PASSWORD 
parameters, the system assigns the RACF default group name associated with the specified 
userid. 
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Relationship to Other Parameters 



If the JOB statement contains a GROUP parameter, the statement must also contain USER 
and PASSWORD parameters. 

Example of the GROUP Parameter 



//TEST JOB '083,123456' ,GROUP=MYGROUP,USER=MYNAME,PASSWORD=ABC 

This statement requests that the system connect RACF-defined user MYNAME to the group 
named MYGROUP for the duration of the job. 
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JOB: MSGCLASS 



MSGCLASS Parameter 

Parameter Type: Keyword, optional 

Purpose: Use the MSGCLASS parameter to assign the job log to an output class. The job log 
is a record of job-related information for the programmer. Depending on the JOB statement 
MSGLEVEL parameter, the job log can consist of: 

• Only the JOB statement. 

• All job control statements. 

• In-stream and cataloged procedure statements. 

• Job control statement messages. 

• JES and operator messages about the job. 

Syntax: 



MSGCLASS=class 



Subparameter Definition 
class 



Defaults 



Identifies the output class for the job log. The class is one character, A through Z or 
through 9, and must be a valid output class specified at JES initialization. 



The default is based on the source of the job: The system places the job log in the same output 
class as the installation-specified default class for the particular card reader, work station, or 
time-sharing user that submitted the job. The installation default is specified at JES 
initialization. 



Significance of Output Classes 



h 



To print the job log and any output data sets on the same output listing, code one of the 
following: 

• The same output class in the DD SYSOUT parameter as in the JOB MSGCLASS 
parameter. 

• DD SYSOUT = * to default to the JOB MSGCLASS output class. 

• DD SYSOUT = (,) to default to one of the following: 

1. The CLASS parameter in an explicitly or implicitly referenced OUTPUT JCL 
statement. In this case, the OUTPUT JCL CLASS parameter should specify the same 
output class as the JOB MSGCLASS parameter. 

2. The JOB MSGCLASS output class, if no OUTPUT JCL statement is referenced or if 



'^ the referenced OUTPUT JCL statement contains CLASS = *. 
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Examples of the MSGCLASS Parameter 



//EXMPl JOB , GEORGE, MSGCLASS=F 

In this example, the JOB statement specifies output class F for the job log. 

//EXMP2 JOB ,MENTLE,MSGLEVEL=(2,0) 

This JOB statement does not specify an output class. In this case, the output class defaults to 
the installation default output class for the device from which the job was submitted. 

//A1403 JOB , BLACK, MSGCLASS=L 
//STEPl EXEC PGM=PRINT 
//OUTDDl DD SYSOUT=L 

In this example, the JOB statement and sysout DD statement OUTDDl both specify the same 
output class. Consequently, the job log and data set OUTDDl are written on the same output 
listing. 

//B209 JOB , WHITE, MSGCLASS=M 
//STEPA EXEC PGM=PRINT 
//OUTDDX DD SYSOUT=* 

In this example, the JOB statement specifies that the system route the job log to output class 
M. The system also routes syscut data set OUTDDX to class IvI because SYSOUT = * is 
specified. 
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MSGLEVEL Parameter 

Parameter Type: Keyword, optional 

Purpose: Use the MSGLEVEL parameter to control listing of the job log. You can request 
that the system print the following: 

• Only the JOB statement. 

• All job control statements in the input stream, that is, all JCL statements and JES2 or JES3 
statements. 

• In-stream and cataloged procedure statements for any procedure a job step calls. 

• Messages about job control statements. 

• JES and operator messages about the job's processing: allocation of devices and volumes, 
execution and termination of job steps and the job, and disposition of data sets. 

Syntax: 



MSGLEVEL=( [statements! [ , messages] ) 



You can omit the parentheses if you code only the first subparameter. 



Subparameter Definition 



statements 

Indicates which job control statements the system is to print in the job log. statements is 
one of the following numbers: 

The system prints only the JOB statement. 

1 The system prints all JCL statements, JES2 or JES3 control statements, the procedure 
statements, and IEF653I messages, which give the values assigned to symbolic 
parameters in the procedure statements. 

2 The system prints only JCL statements and JES2 or JES3 control statements. 

messages 

Indicates which messages the system is to print in the job log. messages is one of the 
following numbers: 

The system prints only JCL messages. It prints JES and operator messages only if the 
job abnormally terminates. 

1 The system prints JCL messages and all JES and operator messages. 
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Defaults 

If you do not code the MSGLEVEL parameter, JES uses an installation default specified at 
initialization. 

Examples of the MSGLEVEL Parameter 



//EXMP3 JOB , GEORGE, MSGLEVEL=( 2,1) 

In this example, the JOB statement requests that the system print only JCL statements, JCL 
messages, and JES and operator messages, 

//EXMP4 JOB ,MENTLE,MSGLEVEL=0 

In this example, the JOB statement requests that the system print only the JOB statement and 
that JES is to use the installation default for messages. 

//EXMP5 JOB ,MIKE,MSGLEVEL=(,0) 

In this example, the JOB statement requests that JES use the installation default for printing 
JCL statements and the system is not to print JES and operator messages unless the job 
abnormally terminates. 
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JOB: NOTIFY 



NOTIFY Parameter 



Parameter Type: Keyword, optional 

Purpose: Use the NOTIFY parameter to request that the system send a message to your TSO 
userid or another TSO userid when this background job completes processing. 

Syntax: 



NOTIFY=userid 



Subparameter Definition 

userid 

Identifies the user that the system is to notify. The userid is 1 through 7 alphanumeric 
characters and must be a valid TSO userid. 

Relationship to JES2 /*JOBPARM SYSAFF Parameter 

If you submit a TSO job with a JOB statement NOTIFY parameter or the job includes a JES2 
/*NOTIFY statement, do not specify IND in a JES2 /*JOBPARM SYSAFF parameter; the 
IND subparameter would change the mode of the job. This change would be invaUd because 
the mode of the job must match the mode of the system at which the job is submitted. 

Receiving Notification of Job Completion 

In a JES2 System: If you are logged on to the member of the JES2 multi-access spool from 
which you submitted the job, the system immediately notifies you when the job completes. If 
you are not logged on, the system saves the message until you log on to the member from 
which you originally submitted the job. 

In a JES3 System: If you are logged on, the system immediately notifies you when the job 
completes. If you are not logged on, the system saves the message until you log on to the 
system from which you originally submitted the job. 

To receive notification that a job you submitted through batch processing has completed, code 
an ACMAIN parameter on a JES3 //*MAIN statement in addition to the JOB statement 
NOTIFY parameter. The ACMAIN parameter names the processor on which your TSO system 
is running. 

Example of the NOTIFY Parameter 



//SIGN JOB , JEEVES , N0TIFY=P0K1 

When the job SIGN completes processing, the system sends a message to userid POKl. 
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PASSWORD Parameter 

Parameter Type: Keyword, optional 

Purpose: Use the PASSWORD parameter to identify a current RACF password or specify a 
new RACF password. You can specify a new password at any time and must specify a new 
password when your current one expires. 

If the installation specified JES early user verification in its RACF options and contains the 
user exit routine needed to verify the password, a new password specified in the PASSWORD 
parameter takes effect when the job is read in. The new password takes effect even if the job is 
held for execution later and may take effect even if the job fails because of JCL errors. When 
changing the password, other jobs that use the new or old password may fail, depending on 
when their passwords are verified. 

If the installation contains the feature for propagation of the user and group identification, the 
USER, the PASSWORD, and, optionally, the GROUP parameters are required on JOB 
statements only for the following: 

• Batch jobs submitted through an input stream, such as a card reader, (1) if the job requires 
access to RACF-protected resources or (2) if the installation requires that all jobs have 
RACF identification. 

• Jobs submitted by one TSO user for another user. In this case, the JOB statement must 
specify the other user's userid and password. The group id is optional. 

• Jobs that execute at another network node that uses RACF protection. 

Otherwise, the USER, PASSWORD, and GROUP parameters can be omitted from JOB 
statements. RACF uses the userid, password, and default group id of the submitting TSO user 
or job. 

References: For more information on using RACF-protected facilities, see Resource Access 
Control Facility (RACF) General Information Manual. 

Syntax: 



PASSWORD= (password [ , new-password] ) 



• You can omit the parentheses if you code only the first subparameter. 

• The PASSWORD parameter must be on the first statement if the JOB statement is 
continued. 
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Subparameter Definitioii 

password 

Specifies the user's current RACF password. The password is 1 through 8 alphanumeric 
or national characters. 

new-password 

Specifies the user's new RACF password. The new-password is 1 through 8 alphanumeric 
or national characters. The installation's security administrator can impose additional 
' restrictions on passwords; follow your installation's rules. 

Relationship to Other Parameters 

If the installation does not contain the user and group identification propagation feature: 

• Code a PASSWORD parameter when coding a USER or GROUP parameter on a JOB 
statement. 

• Code a USER parameter when coding a PASSWORD parameter. 
Examples of the PASSWORD Parameter 

//TESTl JOB '083,12 3456" ,PASSWORD=ABCDE,USER=MYNAME 
This JOB statement identifies ABCDE as the current password for the RACF user. 
//TEST2 JOB '083,123456' ,PASSW0RD=(BCH,A12) ,USER=RAC1,GR0UP=GRP1 
This JOB statement requests that the system change the RACF password from BCH to A12. 
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PERFORM Parameter 



Parameter Type: Keyword, optional 

Purpose: Use the PERFORM parameter to specify the performance group for the job. The 
installation-defmed performance groups determine the rate at which associated jobs have access 
to the processor, storage, and channels. 



Syntax: 



PERFORM=n 



Subparameter Definition 



Defaults 



Overrides 



Requests a performance group. The n is a number from 1 through 999 and must identify 
a performance group that has been defined by your installation. The specified 
performance group should be appropriate for your job type according to your 
installation's rules. 



It no PERFORM parameter is specified or if the specified PERFORM number fails validity 
checks, the system uses an installation default specified at initiaUzation. If the installation did 
not specify a default, the system uses a built-in default: 



Default Use 



For non-TSO jobs 
For TSO sessions 



See SPL: Initialization and Tuning for details. 



A JOB statement PERFORM parameter applies to all steps of the job and overrides any EXEC 
statement PERFORM parameters. 

Code EXEC statement PERFORM parameters when each job step executes in a different 
performance group. The system uses an EXEC statement PERFORM parameter only when no 
PERFORM parameter is on the JOB statement and only during the job step. 



Example of the PERFORM Parameter 



//STEPl JOB ,MARLA,CLASS=D,PERFORM=25 

In this example, CLASS = D determines the class in which the system will execute the job. 
Once in the system, the job will run in performance group 25. The installation must have 
defined the significance of this performance group. 
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Programmer's Name Parameter 



Parameter Type: Positional, required (according to installation procedures) 

Purpose: Use the programmer's name parameter to identify the person or group responsible 
for a job. 

Syntax: 




Location: Place the programmer's name parameter immediately after the accounting 
information parameter and before all keyword parameters. 

Omission: Do not code a comma to indicate the absence of the programmer's name 
parameter. For example: 

//JOBA JOB '058/706' ,MSGCLASS=A 

Special Characters: Enclose the programmer's name in apostrophes when: 

• The name contains special characters, other than hyphens, leading periods, or embedded 
periods. For example: 

//JOBB JOB ,S-M-TU 

y/JOBC JOB , .ABC 

//JOBD JOB ,P.F.M 

// JOBE JOB , • BUILD/PAUL ' 

//JOBF JOB ,'MAE BIRDSALL' 

• The last character of the name is a period. For example: 
//JOBG JOB , 'A.B.C. ' 

• Code each apostrophe that is part of the name as two consecutive apostrophes. For 
example, code O'DONNELL as C'DONNELL'. 



Parameter Definition 



programmer's-name 

Identifies the job's owner. The name must not exceed 20 characters, including all special 
characters. 



Examples of the Programmer's Name Parameter 



//AFP JOB , G.M.HILL 

This. JOB statement specifies a programmer's name with no accounting information. The 
leading comma may be optional; check with your installation. 
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//DELTA JOB 'T.O''NEILL' 

The programmer's name contains special characters. The installation requires no accounting 
information. The imbedded apostrophe is coded as two consecutive apostrophes; the entire 
name must be enclosed in apostrophes. 

//#308 JOB (846349,GROUP12) .MATTHEW 

This JOB statement specifies an account number, additional accounting information, and a 
programmer's name. 

//JOBA JOB 'DEPT. 15E ' 

This installation requires the department number in the programmer's name parameter. 
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PRTY Parameter 



Parameter Type: Keyword, optional 

Purpose: Use the PRTY parameter to assign a selection priority to your job. Within a JES2 
job class or a JES3 job class group, the system selects jobs for execution in order by priority. A 
job with a higher priority is selected for execution sooner; jobs with the same priority are 
selected on a first-in first-out basis. 

Note: Depending on the JES2 initialization options in use at your installation, JES2 may 
ignore the PRTY parameter. 

References: For more information about priority, see SPL: JES2 Initialization and Tuning. 

Syntax: 



PRTY=prioritY 



Subparameter Definition 



Defaults 



prilority 

Requests a priority for the job. The priority is a number from through 15 for JES2 and 
from through 14 for JES3. The highest priority is 15 or 14. 

Follow your installation's rules in coding a priority. 



JES2 determines the job priority from the following, in override order: 

1 . A JES2 /*PRIORITY statement. 

2. A PRTY parameter on the JOB statement. 

3. A value calculated from the accounting information on a JES2 /*JOBPARM statement or 
the JOB statement. 

4. An installation default specified at JES2 initiaUzation. 

JES3 determines the job priority from the following, in override order: 

1. A PRTY parameter on the JOB statement. If the specified priority is invalid, JES3 issues 
an error message. 

2. An installation default specified at JES3 initialization. 
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JOB: PRTY 

Overrides 



To assign a different priority to a particular step in the job, code the DPRTY parameter on the 
EXEC statement for that step. The job's priority applies to any step without a DPRTY 
parameter. 



Example of the PRTY Parameter 



// JOBA JOB 1 , ' JIM WEBSTER ' , PRTY=12 
This job has a priority of 12. 
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RD Parameter 



Parameter Type: Keyword, optional 

Purpose: Use the RD (restart definition) parameter to: 

• Request that the operator perform automatic step restart if the job fails. 

• Suppress, partially or totally, the action of the assembler language CHKPT macro 
instruction or the DD statement CHKPT parameter. 

The system can perform automatic restart only if all of the following are true: 

• The JOB or EXEC statement contains RD = R or RD = RNC. 

• The step to be restarted returned a completion code that indicated no error in the step. 

• The operator authorizes a restart. 

• The job has a job journal. 

A job journal is a sequential data set that contains job-related control blocks needed for restart. 
For JES2, specify a job journal by one of the following: 

• An installation option during JES2 initiaUzation. 

• RD = R or RD = RNC on either the JOB statement or any one EXEC statement in the job. 

• RESTART parameter on the JOB statement. 

For JESS, specify a job journal by one of the following: 

• An installation option during JESS initialization. 

• RD = R or RD = RNC on either the JOB statement or any one EXEC statement in the job. 

• JOURNAL = YES on a JESS //*MAIN statement in the job. 

References: For detailed information on deferred checkpoint restart, see Checkpoint j Restart 
User's Guide. 

Syntax: 
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Subparameter Definition 



R (Restart, Checkpoints Allowed) 

Indicates that the operator is to perform automatic step restart if the job fails. 

RD = R does not suppress checkpoint restarts: 

• If the processing program executed in a job step does not include a CHKPT macro 
instruction, RD = R allows the system to restart execution at the beginning of the 
abnormally terminated step. 

• If the program includes a CHKPT macro instruction, RD = R allows the system to 
restart execution at the beginning of the step, if the step abnormally terminates before 
the CHKPT macro instruction is executed. 

• If the step abnormally terminates after the CHKPT macro instruction is executed, 
only checkpoint restart can occur. If you cancel the affects of the CHKPT macro 
instruction before the system performs a checkpoint restart, the request for automatic 
step restart is again in effect. 

RNC (Restart, No Checkpoints) 

Indicates that the operator is to perform automatic step restart if the job fails. 

RD = RNC suppresses automatic and deferred checkpoint restarts. It suppresses: 

w Any CHKPT macro instruction in the processing program: That is, the operator is 
not to perform an automatic checkpoint restart, and the system is not to perform a 
deferred checkpoint restart if the job is resubmitted. 

• The DD statement CHKPT parameter. 

® The checkpoint at end-of-volume (EOV) facility. 

NR (No Automatic Restart, Checkpoints Allowed) 

Indicates that the operator is not to perform automatic step restart if the job fails. 

RD = NR suppresses automatic checkpoint restart but permits deferred checkpoint 
restarts. It permits: 

• A CHKPT macro instruction to estabUsh a checkpoint. 

• The job to be resubmitted for restart at the checkpoint. On the JOB statement when 
resubmitting the job, specify the checkpoint in the RESTART parameter. 

If the system fails, RD = NR does not prevent the job from restarting. 

NC (No Automatic Restart, No Checkpoints) 

Indicates that the operator is not to perform automatic step restart if the job fails. 

RD = NC suppresses automatic and deferred checkpoint restarts. It suppresses: 

® Any CHKPT macro instruction in the processing program. 

• The DD statement CHKPT parameter. 

• The checkpoint at EOV facility. 
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Defaults 

If no RD parameter is specified, the terminated job step is eligible for automatic 
checkpoint/restart, if its program requested checkpoints with a CHKPT macro instruction. 

Overrides 

A JOB statement RD parameter applies to all steps of the job and overrides any EXEC 
statement RD parameters. 

Code EXEC statement RD parameters when each job step requires different restart types. The 
system uses an EXEC statement RD parameter only when no RD parameter is on the JOB 
statement and only during the job step. 

Relationship to Other Control Statements 

RD = NC or RD = RNC suppresses the action of the DD statement CHKPT parameter. 

Examples of the RD Parameter 

//JILL JOB 333,TOM,RD=R 

RD = R specijfies that the operator is to perform automatic step restart if the job ilails. 

//TRY56 JOB 333,DICK,RD=RNC 

RD = RNC specifies that, if the job fails, the operator is to perform automatic step restart 
beginning with the step that abnormally terminates. RD = RNC suppresses automatic and 
deferred checkpoint restarts. 



//PASS JOB (721,994) .HARRY, RD=NR 

RD=NR specifies that the operator is not to perform automatic step restart or automatic 
checkpoint restart. However, a CHKPT macro instruction can establish checkpoints to be used 
later for a deferred restart. 
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REGION Parameter 



Parameter Type: Keyword, optional 

Purpose: Use the REGION parameter to specify the amount of space that the job requires. 

The specified or default region size sets an upper boundary to limit region size for 
variable-length GETMAINs. The system uses the upper boundary for variable-length 
GETMAINs as long as the region still has available at least the minimum amount of storage 
requested. 

In addition, the IBM- or installation-supplied routine lEALIMIT or lEFUSI uses the region 
size to establish a second hmiting value. The system uses this second value to hmit: 

• Fixed-length GETMAINs. 

• Variable-length GETMAINs when the space remaining in the region is less than the 
minimum requested. 

If the minimum requested length for variable-length GETMAINs or the amount requested for a 
fixed-length GETMAIN exceeds this second value, the job or job step abnormally terminates. 

REGION = OK or REGION = OM gives the job all the storage available in the private area, that 
is, from the top of the system region to the bottom of the common service area (CSA). The 
resulting size of the region is unpredictable. 

References: For more information on the region size and the routine, see SPL: System 
Modifications. 

Syntax: 



REGION= 



valueK 
valueM 



Subparameter Definition 



valueK 

Specifies the required storage in kilobytes (1 kilobyte = 1024 bytes). The value is 1 
through 7 decimal numbers, from 1 through 2096128. Code an even number. For 
example, REGION = 66K. If you code an odd number, the system treats it as the next 
highest even number. 

valueM 

Specifies the required storage in megabytes (1 megabyte = 1024 kilobytes). The value is 
1 through 4 decimal numbers, from 1 through 2047. Code either an even or odd number. 
For example, REGION = 3M. 
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Defaults 



If no REGION parameter is specified, the system uses an installation default specified at JES 
initialization. 

Overrides 

A JOB statement REGION parameter applies to all steps of the job and overrides any EXEC 
statement REGION parameters. 

Code EXEC statement REGION parameters when each job step requires a different region size. 
The system uses an EXEC statement REGION parameter only when no REGION parameter is 
on the JOB statement and only during the job step. 

Relationship to the JOB ADDRSPC Parameter 

When ADDRSPC ''REAL: Code a REGION parameter to specify how much real storage the 
job needs. If you omit the REGION parameter, the system uses the default. 

When ADDRSPC'' VIRT or ADDRSPC is Omitted: Code a REGION parameter to specify 
how much virtual storage the job needs. If you omit the REGION parameter, the system uses 
the default. 

Examples of the REGION Parameter 



//ACCTl JOB A23,SMITH,REGION=100K,ADDRSPC=REAL 
This JOB statement indicates that the job requires lOOK of real storage. 

//ACCT4 JOB 175, FRED, REGION=250K 

This JOB statement indicates that the job requires 250K of virtual storage. When the 
ADDRSPC parameter is omitted, the system defaults to ADDRSPC = VIRT. 
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RESTART Parameter 



Parameter Type: Keyword, optional 

Purpose: Use the RESTART parameter to restart a job. You can specify that the system 
perform either of two restarts: 

• Deferred step restart, which is a restart at the beginning of a job step. 

• Deferred checkpoint restart, which is a restart from a checkpoint taken during step 
execution by a CHKPT macro instruction. 

References: For detailed information on the deferred checkpoint restart, see Checkpoint I Restart 
User's Guide. 



Syntax: 



RESTART=J 



stepname 

stepname .procstepname 



[ ,checkid] 



You can omit the parentheses if you code only the first subparameter. 



Subparameter Definition 



Indicates that the system is to restart execution (1) at the beginning of or within the first 
job step or (2), if the first job step calls a cataloged or in-stream procedure, at the 
beginning of or within the first procedure step. 

stepname 

Indicates that the system is to restart execution at the beginning of or within a job step. 
Stepname identifies the EXEC statement of the job step. 

stepname.procstepname 

Indicates that the system is to restart execution at the beginning of or within a step of a 
cataloged procedure. Stepname identifies the EXEC statement of the job step that calls 
the procedure; procstepname identifies the EXEC statement of the procedure step. 

checkid 

Specifies the name of the checkpoint at which the system is to restart execution. This 
checkpoint must be in the job step specified in the first subparameter. 

Omit checkid to request restart at the beginning of the specified job step. 

When the name contains special characters, enclose it in apostrophes. Code each 
apostrophe that is part of the name as two consecutive apostrophes. For example, code 
CHPT'l as 'CHPT'T. 
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Relationship to Other Control Statements 

When the system is to restart execution in a job step, place a SYSCHK DD statement 
immediately following the JOB statement. The SYSCHK DD statement defines the data set on 
which the system entered the checkpoint for the step being restarted. 

When preparing for a deferred checkpoint, code the DISP abnormal termination disposition 
subparameter in the step's DD statements as follows: 

• KEEP, to keep all data sets that the restart step is to use. 

• CATLG, to catalog all data sets that you are passing from steps preceding the restart step 
to steps following the restart step. 

In JES2 systems, you can also use the RESTART parameter on the /*JOBPARM control 
statement. 

In JESS systems, use can also use the FAILURE parameter on the //*MAIN control statement. 

Cautions when Coding the RESTART Parameter 

Before resubmitting a job: 

• Check all backward references to steps before the restart step. EHminate all backward 
references in EXEC statement PGM parameters and DD statement VOLUME == REF 
parameters. 

• Review all EXEC statement COND parameters. If any of the COND parameters reference 
a step before the restart step, be aware that the system ignores the return code tests for 
those steps. 

Generation Data Sets in Restarted Jobs 

In the restart step or following steps, do not use the original relative generation numbers to 
refer to generation data sets that were created and cataloged before the restart step. Instead, 
refer to a generation data set by its present relative generation number. 

For example, if the last generation data set created and cataloged was assigned a generation 
number of + 2, refer to it as in the restart step and following steps. If generation data set + 1 
was also created and cataloged, refer to it as -1. 

If generation data sets created in the restart step were kept instead of cataloged, that is, 
DISP = (NEW,CATLG,KEEP) was coded, then refer to them by the same relative generation 
numbers used to create them. 
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Examples of the RESTART Parameter 



//LINES JOB '1/17/85' ,RESTART=COUNT 

This JOB statement indicates that the system is to restart execution at the beginning of the job 
step named COUNT. 

//{3LOC5 JOB '4/11/86' ,RESTART= (PROCESS, CHKPT3) 
//SYSCHK DD DSNAME=CHK,UNIT=3330,DISP=OLD 

The JOB statement indicates that the system is to restart execution at checkpoint CHKPT3 in 
job step PROCESS. The SYSCHK DD statement must follow the JOB statement; it defines 
the data set on which the system wrote checkpoint CHKPT3. 

//WORK JOB , PORTER , RESTART= ( * , CKPT2 ) 
//SYSCHK DD DSNAME=CHKPT,UNIT=3330,DISP=OLD 

The JOB statement indicates that the system is to restart execution at checkpoint CKPT2 in the 
first job step. The SYSCHK DD statement defines the data set on which the system wrote 
checkpoint CKPT2. 

//CLIPS JOB , COLLINS, RESTART=( PAY. WEEKLY, CHECKS) 
//SYSCHK DD DSNAME=CHKPT,UNIT=3350,DISP=OLD 

The JOB statement indicates that the system is to restart execution at checkpoint CHRCK8 in 
procedure step WEEKLY. PAY is the name field on the EXEC statement that calls the 
cataloged procedure that contains procedure step WEEKLY. The SYSCHK DD statement 
defines the data set on which the system wrote checkpoint CHECKS. 
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TIME Parameter 



Parameter Type: Keyword, optional 

Purpose: Use the TIME parameter to specify the maximum length of time that a job is to use 
the processor and to find out through messages how much processor time the job used. 

The system terminates a job that exceeds the specified time limit unless a user exit routine 
extends the time. The exit routine is established through System Management Facilities (SMF). 

References: See SPL: System Management Facilities (SMF). 

Syntax: 



TIME= 



( [minutes] [ , seconds] ) 
1440 



You can omit the parentheses if you code only 1440 or the processor time in minutes. 

If you omit the seconds, do not code a null subparameter. For example, TIME = (60,) is 
invalid. 



Subparameter Definition 



minutes 

Specifies the maximum number of minutes the job can use the processor. The minutes 
must be a number from 1 through 1439. 

Do not code TIME = on the JOB statement. The results are unpredictable. 

seconds 

Specifies the maximum number of seconds that the job can use the processor^ in addition 
to any minutes that are specified. The seconds must be a number from 1 through 59. 

1440 

Indicates that the job can use the processor for an unlimited amount of time; 1440 
literally means 24 hours. Code TIME = 1440 for the following reasons: 

• To obtain job accounting information. 

• To specify that the system is to allow any of the job's steps to remain in a continuous 
wait state for more than the installation time limit, which is estabUshed through SMF. 
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Defaults 



Overrides 



If no TIME parameter is specified, JES uses an installation default specified at initialization. 
If 1440 is not specified, SMF uses its current job wait time limit. 



For a JOB statement TIME parameter other than TIME = 1440, the system sets the time limit 
for each step to: 

• The step time limit specified on the EXEC statement TIME parameter. 

• If no EXEC TIME parameter was specified, (1) the default time hmit or (2) the job time 
remaining after execution of previous steps, whichever is smaller. 



Time Handling 

How the System Converts the Time Value: The job time limit or the time remaining after 
execution of previous steps in a job is converted by the system to seconds and then rounded to 
the nearest unit, where 1 unit= 1.048576 seconds. Thus, a step can begin execution with up to 
one-half unit more or one-half unit less time than expected. If the time remaining for the job is 
less than one-half unit, a step will begin execution with zero time, resulting in an abnormal 
termination. 

Time Checking: Because the system checks the processor time-used field about every 10.5 
seconds, the actual time that a job uses the processor can exceed the specified TIME value by 
up to 10.5 seconds. For example, the system checks the job's time-used field and finds 0.5 
seconds remaining. Because the system does not again check the job's time-used field for about 
10.5 seconds, the job can execute for an additional 10.5 seconds and thus exceed the coded 
TIME value by 10 seconds. 

Examples of the TIME Parameter 



//STDl JOB ACCT271,TIME=(12,10) 

This statement specifies that the maximum amount of time the job can use the processor is 12 
minutes, 10 seconds. 

//TYPE4 1 JOB , GORDON , TIME= (,30) 

This statement specifies that the maximum amount of time the job can use the processor is 30 
seconds. 

//FORMS JOB , MORRILL , TIME=5 

This statement specifies that the maximum amount of time the job can use the processor is 5 
minutes. 
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//RAINCK JOB 374231, MORRISON, TIME=1440 

This statement specifies an unlimited amount of time for job execution; the job can use the 
processor and remain in wait state for an unspecified period of time. The system will issue 
messages telling how much processor time the job used. 



Examples of the TIME Parameter on JOB and EXEC Statements 



//FIRST JOB 
//STEPl EXEC 



, SMITH, TIME=2 
PGM=READER,TIME=1 



//STEP2 EXEC 



PGM=WRITER , TIME=1 



In this example, the job is allowed 2 minutes for execution and each step is allowed 1 minute. 
If either step continues executing beyond 1 minute, the entire job abnormally terminates 
beginning with that step. 



//SECOND JOB 
//STEPl EXEC 



, JONES, TIME=3 
PGM=ADDER,TIME=2 



//STEP2 EXEC 



PGM='PRINT,TIME=2 



In this example, the job is allowed 3 minutes for execution, and each step is allowed 2 minutes. 
If either step continues executing beyond 2 minutes, the entire job abnormally terminates 
beginning with that step. If STEPl executes for 1.74 minutes and STEP2 tries to execute 
beyond 1.26 minutes, the job abnormally terminates because of the 3-minute limit specified on 
the JOB statement. 
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TYPRUN Parameter 



Parameter Type: Keyword, optional 

Purpose: Use the TYPRUN parameter to request special job processing. The TYPRUN 
parameter can tell the system to: 

• In a JES2 system, copy the input job stream directly to a sysout data set and schedule it for 
output processing. 

• In a JES2 or JES3 system, place a job on hold until a special event occurs. When the event 
occurs, the operator, following your directions, must release the job from its hold to allow 
the system to select the job for processing. Use the JES2 /*MESSAGE statement or the 
JES3 //*OPERATOR statement to notify the operator to release the job. 

• In a JES2 or JES3 system, scan a job's JCL for syntax errors. 
Syntax: 



TYPRUN= 


COPY 
HOLD 
JCLHOLD 
SCAN 





Subparameter Definition 



COPY (JESlonly) 

Requests that JES2 copy the input job stream, as submitted, directly to a sysout data set 
and schedule the sysout data set for output processing. The system does not schedule the 
job for execution. The class of this sysout data set is the same as the message class of the 
job and is controlled by the JOB MSGCLASS parameter. 

Note: COPY is supported only in JES2 systems. 

HOLD 

Requests that the system hold the job before execution until the operator releases it. The 
operator should release the job when a particular event occurs. If an error occurs during 
input service processing, JES does not hold the job. 



JCLHOLD (JESlonly) 

Requests that JES2 hold the job before completing JCL processing. JES2 holds the job 
until the operator releases it. 

Note: JCLHOLD is supported only in JES2 systems. 
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SCAN 



Requests that the system scan this job's JCL for syntax errors, without executing the job 
or allocating devices. This parameter asks the system to check for: 

• Invalid spelling of parameter keywords and some subparameter keywords. 

• Invahd characters. 

• Unbalanced parentheses. 

• Misplaced positional parameters on some statements. 

• In a JES3 system only, parameter value errors or excessive parameters. 

• Invalid syntax on JCL statements in cataloged procedures invoked by any scanned 
EXEC statements. 

The system does not check for misplaced statements, for invalid syntax in JCL 
subparameters, or for parameters and/or subparameters that are inappropriate together. 

Relationship to Other Control Statements 

In a JES3 system, code PGM = JCLTEST or PGM = JSTTEST on the EXEC statement to scan 
a job step's JCL. JCLTEST or JSTTEST provides for a step the same function as provided by 
TYPRUN = SCAN for a job. 

Example of the TYPRUN Parameter 



//UPDATE JOB , HUBBARD 
//STEPl EXEC PGM=LIBUTIL 



//LIST JOB , HUBBARD, TYPRUN=HOLD 
//STEPA EXEC PGM=LIBLIST 



Jobs UPDATE and LIST are submitted for execution in the same input stream. UPDATE 
executes a program that adds and deletes members of a library; LIST executes a program that 
Usts the members of that library. For an up-to-date listing of the library, LIST must execute 
after UPDATE. To force this execution order, code TYPRUN = HOLD on JOB statement 
LIST. 

If a MONITOR JOBNAMES command is executed from the input stream or by the operator, 
the system notifies the console operator when UPDATE completes. The operator can then 
release LIST, allowing the system to select LIST for execution. 
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USER Parameter 



Parameter Type: Keyword, optional 

Purpose: Code the USER parameter to identify to the system the person submitting the job. 
The userid is used by the Resource Access Control Facility (RACF), the system resources 
manager (SRM), and other system components. 

If the installation contains the feature for propagation of the user and group identification, the 
USER, the PASSWORD, and, optionally, the GROUP parameters are required on JOB 
statements only for the following: 

• Batch jobs submitted through an input stream, such as a card reader, (1) if the job requires 
access to RACF-protected resources or (2) if the installation requires that all jobs have 
RACF identification. 

• Jobs submitted by one TSO user for another user. In this case, the JOB statement must 
specify the other user's userid and password. The group id is optional. 

• Jobs that execute at another network node that uses RACF protection. 

Otherwise, the USER, PASSWORD, and GROUP parameters can be omitted from JOB 
statements, RACF uses the userid, password, and default group id of the submitting TSO user 
or job. 

References: For more information on RACF-protected facilities, see Resource Access Control 
Facility (RACF) General Information Manual. 

Syntax: 



USER=userid 



Subparameter Definition 
userid 



Defaults 



Identifies a user to the system. The userid consists of 1 through 7 alphanumeric or 
national characters; the first character must be alphabetic or national. 



If neither the JOB statement nor the submitting TSO user supplies identification information, 
RACF assigns a default userid and group id, unless the job enters the system via a JES internal 
reader. In that case, the user and default group identification of the submitting TSO user or 
job is used. 
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Relationship to Other Parameters 

If the JOB statement contains a GROUP or PASSWORD parameter, the statement must also 
contain a USER parameter. 



Example of the USER Parameter 



//TEST JOB '083,123456' ,USER=MYNAME,PASSWORD=ABCD 
This statement identifies the user submitting this job as MYNAME. 
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Null Statement 



Chapter 16. Null Statement 



Use the null statement to mark the end of a job. 
Syntax: 



// 



• The null statement consists of the characters // in columns 1 and 2. 

• The rest of the statement must be blank. 



Location in the JCL 



Place a null statement (1) at the end of a job's control statements and data and (2) at the end of 
an input stream. 

The system can also recognize the end of a job when it reads the next JOB statement or when 
the input stream contains no more records. 

A null statement that does not end an input stream should be immediately followed by a JOB 
statement. The system ignores statements between a null statement and the next valid JOB 
statement. 

If a null statement follows a control statement that is being continued, the system treats the null 
statement as a blank comment field and assumes that the control statement contains no other 
parameters. 
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Null Statement 

Example of the Null Statement 



//MY JOB JOB , • C BROWN ' 

//STEPl EXEC PROC=FIELD 

//STEP2 EXEC PGM=XTRA 

//DDl DD UNIT=3400-5 

//DD2 DD * 



data 



/* 
// 



The null statement indicates the end of job MYJOB. 
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Chapter 17. OUTPUT JCL Statement 



Purpose: Use the OUTPUT JCL statement to specify processing options for a system output 
(sysout) data set. These processing options are used only when the OUTPUT JCL statement is 
explicitly or implicitly referenced by a sysout DD statement. JES combines the options from 
this OUTPUT JCL statement with the options from the referencing DD statement. 

OUTPUT JCL statements are useful in processing the output of one sysout data set in several 
ways. For example, a sysout data set can be sent to a distant site for printing, as shown in 
statement OUTl, while it is also printed locally, as shown in statement OUT2: 

//OUTl OUTPUT DEST=STLNODE.WMSMITH 

//0UT2 OUTPUT CONTROL=DOUBLE 

//DS DD SYS0UT=C,0UTPUT=(*.0UT1,*.0UT2) 

The parameters you can specify for sysout data set processing are arranged alphabetically in the 
following pages. 

References: For information about the JES initialization parameters that provide installation 
defaults, see SPL: JES2 Initialization and Tuning and SPL: JESS Initialization and Tuning. 

Syntax: 



//name OUTPUT parameter [, parameter] .. . [coiranents] 



The OUTPUT JCL statement consists of the characters // in columns 1 and 2 and four 
fields: name, operation (OUTPUT), parameter, and comments. 



Name Field 

Code a name in the name field of every OUTPUT JCL statement, as follows: 

• Each OUTPUT JCL name must be unique within a job. 

• The name must begin in column 3. 

• The name is 1 through 8 alphanumeric or national characters. 

• The first character must be alphabetic or national. 

• The name must be followed by at least one blank. 
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Operation Field 



The operation field consists of the characters OUTPUT and must be preceded and followed by 
at least one blank. It can begin in any column. 



Parameter Field 



The OUTPUT JCL statement contains only keyword parameters. AH parameters are optional; 
however, do not leave the parameter field blank. You can code any of the keyword parameters 
in any order in the parameter field. 



KEYWORD PARAMETERS 


VALUES 


PURPOSE 


BURST = 

See page 17 


YES 

Y 

NO 

N 

-9 




YES or Y: burster-trimmer-stacker 
NO or N: continuous forms stacker 


Directs output to a stacker 
on a 3800 Printing Subsystem. 


CHARS = 

See page 17 


table-name 

(table-name[,table-name] . . .) 

STD 

DUMP 

DUMP[,table-name]...) 

-11 




1 - 4 table-name subparameters: 1 - 4 
alphanumeric or national characters 
STD: character-arrangement table (JES3 only) 
DUMP: 204-character print lines on 3800 
dump 


Names character-arrangement 
tables for printing on a 3800 
Printing Subsystem. Can request 
a high-density dump on a 
SYSABEND or SYSUDUMP 
DD statement. 


CKPTLINE = nnnnn 
See page 17-14 


nnnnn: - 32767 


Specifies the maximum lines in a 
logical page. (JES3 support is 
limited to 3800 Printing 
Subsystem Models 3 and 8.) 


CKPTPAGE = nnnnn 
See page 17-15 


nnnnn: 1 - 32767 


Specifies the number of logical 
pages to be printed or transmitted 
before JES takes a checkpoint. 
(JES3 support is limited to 3800 
Printing Subsystem Models 
3 and 8.) 


CKPTSEC = nnnnn 
See page 17-16 


nnnnn: 1 - 32767 


Specifies how many seconds of 
printing are to elapse between 
each checkpoint of this sysout 
data set. (JES3 support is limted 
to 3800 Printing Subsystem 
Models 3 and 8.) 


CLASS = class 

* 

See page 17-17 


class: A - Z, - 9 

*: same output class as MSGCLASS 
parameter on JOB statement 


Assigns the sysout data set to an 
output class. 
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KEYWORD PARAMETERS 


VALUES 


PURPOSE 


COMPACT = corapaction-table-name 


compaction-table-name: 1 - 8 alphanumeric 


Specifies a compaction table for 




characters 


sending this sysout data set to a 
SNA remote terminal. 


See page 17-20 








PROGRAM 




PROGRAM: each logical record begins with 


Specifies that the data set records 


CONTROL = 


SINGLE 




a carriage control character 


begin with carriage control 




DOUBLE 




SINGLE: single spacing 


characters or specifies line 




TRIPLE 




DOUBLE: double spacing 


spacing. 


> / 


TRIPLE: triple spacing 




See page 17-21 






nnn 


nnn (JES2): 1 - 255 


Specifies number of copies printed. 


COPIES = (,(group-Yalue[,group-value]. . .)) 


nnn (JES3): 1 - 254 


For a 3800 Printing Subsystem, 




1 - 8 group-values (JES2): 1 - 255 


can instead specify number of 




1 - 8 group values (JES3): 1 - 254 


copies of each page printed before 
the next page is printed. 


See page 17-22 






DEFAULT = 


YES 




YES or Y: this statement can be implicitly 


Specifies that this is a default 




Y 

NO 

N 




referenced by sysout DD statements 
NO or N: this statement cannot be implicitly 
referenced by sysout DD statements. 


OUTPUT JCL statement. 


See page 17-25 






DEST = destination 


LOCAL: local device 


Sends a sysout data set to the 




name: named local or remote device 


specified destination. 


destination (JES2): 


Nnnnn: node (1 - lOOO) 




LOCAL 


NnRm: node (1 - 1000) and remote work 




name 


station (1 - 4000); 6 digits maximum 




Nnnnn 


for n and m combined 




NnnRmmmm to NnnnnRmm 


nodename.userid: node (1-8 




nodename.userid 


alphanumeric characters) and userid (1-8 




Rnnnn or RMnnnn or RMTnnnn 


alphanumeric characters) 




Unnnn 


Rnnnn or RMnnnn or RMTnnnn: remote 
terminal (1 - 4000) 




destination (JES3): 


Unnnn: local terminal (1 - 4000) 




ANYLOCAL 


ANYLOCAL: any local device 




device-name 


device-name: local device (1 - 8 




group-name 


alphanumeric or national characters) 




nodename 


group-name: 1 or more local devices or 




nodename.remote 


remote stations (1-8 alphanumeric or 




(type) 


national characters) 
nodename: node (1-8 alphanumeric or 

national characters) 
remote: remote work station (1 - 8 

alphanumeric or national characters) 
(type): device classification in the form 

(gggssss), where ggg is general and ssss is 

specific classification 




See page 17-28 






FCB= fcb-name 


fcb-name: 1-4 alphanumeric or national 


Specifies FCB image, carriage 


STD ) 


characters 


control tape for 1403 Printer, or 




STD: standard FCB (JES3 only) 


data-protection image for 3525 
Card Punch. 


Seepage 17-31 
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KEYWORD PARAMETERS 


VALUES 


PURPOSE 


FLASH = (overlay-name[,count]) 
(.count) 
NONF. 
(STD 

See page 17-33 




overlay-iiaiiic. forms overlay frame (1-4 
alphanumeric or national characters) 

count: copies with overlay (0 - 255) 

NONE: suppresses flashing 

STD: standard forms flash overlay 
(JES3 only) 


For prmting on a 3800 Printing 
Subsystem, indicates that the data 
set is to be printed with forms 
overlay and can specify how many 
copies are to be flashed. 


FOR MDEF = membername 
See page 17-36 


membername: i - 6 alphanumeric or 
national characters 


Names a library member 
that PSF uses in printing the 
sysout data set on a 3800 
Printing Subsystem Model 3. 


FORMS = form-name 
STD 1 

Seepage 17-38 


form-name: 1 - 8 alphanumeric or national 

characters 
STD: standard form (JES3 only) 


Identifies forms on which the 
sysout data set is to be printed or 
punched. 


GROUPID = output-group 
See page 17-39 


output: 1 - 8 alphanumeric characters 


Specifies that this sysout data set 
belongs to a user-named output 
group. (JES2 only) 


INDEX = nn 
See page 17-41 


nn: 1 - 31 


Specifies how many print 
positions the left margin is to be 
indented for a sysout data set 
printed on a 321 1 Printer with the 
indexing feature. (JES2 only) 


JESDS = 

See page 1 


ALL 
JCL 
LOG 
MSG 

7-42 




ALT/ all nf job's system-managed data sets 
JCL: all JCL processing data sets 
LOG: job's hard-copy log 
MSG: job's system messages 


managed data sets for the job be 
processed according to the 
parameters on this OUTPUT JCL 
statement. 


LINDEX = nn 
See page 17-44 


nn: 1 - 31 


Specifies how many print 
positions the right margin is to be 
moved in from the full page width 
for a sysout data set printed on a 
3211 Printer with the indexing 
feature. (JES2 only) 


LINECT = nnn 
See page 17-45 


nnn: - 255 


Specifies the maximum lines JES2 
is to print on each page. (JES2 
only) 


MODIFY = module-name 

([module-name][,trc]) 

See page 17-46 




module-name: 1 - 4 alphanumeric or national 

characters 
trc: table-name in CHARS parameter 

(0 for first, 1 for second, 2 for third, 

and 3 for fourth table-name) 


Specifies a copy-modification 
module in SYS 1 .IMAGELIB to 
be used by JES to print the data 
set on a 3800 Printing Subsystem. 
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KEYWORD PARAMETERS 


VALUES 


PURPOSE 


PAGEDEF = membername 
See page 17-48 


membername: 1 - 6 alphanumeric or national 
characters 


Names a library member 
that PSF uses in printing the 
sysout data set on a 3800 
Printing Subsystem Model 3. 


PIMSG = 

Seepage 1' 


YES 

Y 

NO 

N 

'-50 




YES: print messages from a functional 

subsystem 
NO: not print messages from a functional 

subsystem 


Indicates that messages from a 
functional subsystem should or 
should not be printed in the listing 
following the sysout data set. 


PRMODE = 

See page 17-51 


LINE 
PAGE 
process-mode 




LINE: send data set to line-mode printer 
PAGE: send data set to page-mode printer 
process-mode: installation-defined mode 
(1-8 alphanumeric characters) (JES2 only) 


Identifies the process mode 
required to print the sysout data 
set. 


PRTY = nnn 

See page 17-53 


nnn: - 255 (0 is lowest, 255 is highest) 


Specifies initial priority at which 
the sysout data set enters the 
output queue. 


THRESHLD = limit 
See page 17-54 


limit: 1 - 99999999 


Specifies the maximum size for a 
sysout data set. Use it to obtain 
simultaneous printing of large 
data sets or many data sets from 
one job. (JES3 only) 


TRC = 

See page 


YES 

Y 

NO 

N 

17-56 




YES or Y: data set contains TRC codes 
NO or N: data set does not contain TRC 
codes 


Specifies whether or not the 
sysout data set's records contain 
table reference codes (TRC) as 
the second character. 


UCS = character-set-code 
See page 17-58 


character-set-code: 1 - 4 alphanumeric or 
national characters 


Specifies universal character set, 
print train, or character- 
arrangement table for a 3800 
Printing Subsystem. 


WRITER = name 
See page 17-61 


name: 1 - 8 alphanumeric characters 


Names an external writer to 
process the sysout data set rather 
than JES. 



Default OUTPUT JCL Statement: An OUTPUT JCL statement that contains a 
DEFAULT = YES parameter is called a default OUTPUT JCL statement. 

Comments Field 

The comments field follows the parameter field after at least one intervening blank. 
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Location in tlie JCL 



You must place an OT JTPTJT JCL statement in the input stream before any sysout DD 
statement that refers to it. 

References by Sysout DD Statements: An OUTPUT JCL statement can be referenced by a 
sysout DD statement in two ways: 

• Explicitly. The sysout DD statement contains an OUTPUT parameter that specifies the 
name of the OUTPUT JCL statement. 

• Implicitly. The sysout DD statement does not contain an OUTPUT parameter. Implicit 
references are to default OUTPUT JCL statements and require that the job or step contain 
one or more default OUTPUT JCL statements preceding the sysout DD statement. 

Note: If the sysout DD statement does not contain an OUTPUT parameter and the job or 
step does not contain a default OUTPUT JCL statement, processing of the sysout data set is 
controlled only by the DD statement, a JES2 /*OUTPUT statement or JES3 //*FORMAT 
statement, and appropriate installation defaults. 

Job-Level OUTPUT JCL Statements: This statement appears after the JOB statement and 
before the first EXEC statement. 

Step-Level OUTPUT JCL Statements: This statement appears in a step, that is, anywhere after 
the first EXEC statement in a job. 

Location of Default OUTPUT JCL Statements: Where you place default OUTPUT JCL 
statements determines which statements a sysout DD statement refers to in an impUcit 
reference, as follows: 

• A sysout DD statement implicitly references all step-level default OUTPUT JCL statements 
in the same step. 

• A sysout DD statement impUcitly references all job-level default OUTPUT JCL statements 
when the step containing the DD statement does not contain any step-level default 
OUTPUT JCL statements. 

You can place more than one job- or step-level default OUTPUT JCL statement in a job or 
step. 

OUTPUT JCL Statement with JESDS Parameter: Place an OUTPUT JCL statement with a 
JESDS parameter after the JOB statement and before the first EXEC statement. 

OUTPUT JCL Statements in Cataloged or In-Stream Procedures: OUTPUT JCL statements 
can appear in procedure steps. The referencing DD statement can appear later in the 
procedure, in the calling job step, or in a later step in the job. 

An OUTPUT JCL statement must not be placed before the first EXEC statement in a 
procedure; for this reason, procedures cannot contain job-level OUTPUT JCL statements or 
OUTPUT JCL statements with JESDS parameters. 

A procedure DD statement can refer to an OUTPUT JCL statement in an earlier job step or to 
a job-level OUTPUT JCL statement. However, a procedure DD statement cannot refer to an 
OUTPUT JCL statement in the calling step. 
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Job in Input Stream 


//jobname 
//name 


JOB 
OUTPUT . . . 


Job-level OUTPUT JCL statement 


Step 1 


//STEPl 


EXEC PGM=X 






//name 


OUTPUT . . . 


Step-level OUTPUT JCL statement for STEPl 


Step 2 


//DDl 
//DD2 
//DD3 
//STEP2 


DD 
DD 
DD 
EXEC PROC=A 






//name 


OUTPUT . . . 


Step-level OUTPUT JCL statement for STEP2 




//DDl 
//DD2 
//DD3 


DD 
DD 
DD 




Procedure A in 








SYSl.PROCLIB 


// 


PROC 




Procedure Step 1 


//PSTEPl 
//name 


EXEC PGM=G 
OUTPUT . . . 


Step-level OUTPUT JCL statement for PSTEPl 


Procedure Step 2 


//DD4 
//DD5 
//DD6 
//PSTEP2 

//name 


DD 

DD 

DD 

EXEC PGM=H 

OUTPUT . . . 


Step-level OUTPUT JCL statement for PSTEP2 




//DD7 
//DD8 
//DD9 


DD 
DD 
DD 





Figure 17-1. Job- and Step-Level OUTPUT JCL Statements in the JCL 



Overrides 

• Parameters on a sysout DD statement override corresponding parameters on an OUTPUT 
JCL statement. 

• Parameters that appear only on the sysout DD statement or only on the OUTPUT JCL 
statement are used by JES in processing the data set. 

Relationship to Sysout DD Statement 

Do not refer to an OUTPUT JCL statement in a sysout DD statement that defines a JES2 
internal reader. Such a DD statement contains an INTRDR subparameter in the SYSOUT 
parameter. 
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Relationship to the JES2 /*OUTPUT Statement 

JES2 ignores a JES2 /*OUTPUT statement wlien cither of the foiiowing appears in the same 
job or step: 

• A default OUTPUT JCL statement implicitly referenced by the sysout DD statement. 

• An OUTPUT JCL statement explicitly referenced by the OUTPUT parameter of the sysout 
DD statement. 

In this case, JES2 uses the third positional subparameter of the DD SYSOUT parameter as a 
form name, and not as a reference to a JES2 /*OUTPUT statement. 

Relationship to the JES3 //*FORMAT Statement 

• When a sysout DD statement impUcitly or explicitly references an OUTPUT JCL 
statement, JES3 ignores any default JESS //*FORMAT statements in the job. A default 
//* FORMAT statement contains a DDNAME = , parameter. 

• When a JES3 //* FORMAT statement contains a DDNAME parameter that expUcitly 
references a sysout DD statement, JES3 ignores any default OUTPUT JCL statements in 
the job. 

• JES3 uses the processing options from both a JES3 //*FORMAT statement and an 
OUTPUT JCL statement in a job when (1) the //*FORMAT statement DDNAME 
parameter names a sysout DD statement and (2) the sysout DD statement's OUTPUT 
parameter names an OUTPUT JCL statement. Two separate sets of output are created 
from the data set defined by the sysout DD statement: 

- One processed according to the options on the JES3 //*FORMAT statement combined 
with the sysout DD statement. 

- One processed according to the options on the OUTPUT JCL statement combined with 
the sysout DD statement. 
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BURST Parameter 



Parameter Type: Keyword, optional 

Purpose: Use the BURST parameter to specify that the output for the sysout data set printed 
on a 3800 Printing Subsystem is to go to: 

• The burster-trimmer-stacker, to be burst into separate sheets. 

• The continuous forms stacker, to be left in continuous fanfold. 

If the specified stacker is different from the last stacker used, or if a stacker was not previously 
requested, JES issues a message to the operator to thread the paper into the required stacker. 

Note: BURST is vaUd only for a data set printed on a 3800 equipped with a 
burster-timmer-stacker. 



Syntax: 






BURST= rYES] 






Y 




' 


NO 






N 





Subparameter Definition 
YES 



Defaults 



Overrides 



Requests that the printed output is to be burst into separate sheets. This subparameter 
can also be coded as Y. 

NO 

Requests that the printed output is to be in a continuous fanfold. This subparameter can 
also be coded as N. 



If you do not code a BURST parameter and the sysout data set is printed on a 3800 that has a 
burster-timmer-stacker, JES uses an installation default specified at initiaUzation. 



A BURST parameter on the sysout DD statement overrides the OUTPUT JCL BURST 
parameter. 
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Example of the BURST Parameter 



//OUTDSl OUTPUT BURST=YES 

In this example, the output from the 3800 will be burst into separate sheets. 
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CHARS Parameter 



Parameter Type: Keyword, optional 

Purpose: Use the CHARS parameter to specify the name of one or more 
character-arrangement tables for printing the sysout data set on a 3800 Printing Subsystem. 

Note: 

• CHARS is valid only for a data set printed on a 3800. 

• STD is valid only on a JES3 system. 

References: For more information on character-arrangement tables, see the 3800 Printing 
Subsystem Programmer's Guide. Refer to Installation: System Generation for information on 
how to choose during system generation particular groups, other than the Basic group, which is 
always available. 



Syntax: 



CHARS= 



'table-name ^ 

(table-name [ , table-name] . . . ) 
STD t 

DUMP 
(DUMP[ , table-name] . . . ) 



You can omit the parentheses if you code only one table-name. 

Null positions in the CHARS parameter are invalid. For example, you cannot code 
CHARS = (, table-name) or CHARS = (table-name„table-name). 



Subparameter Definition 



table-name 

Names a character-arrangement table. Each table-name is 1 through 4 alphanumeric or 
national characters. Code one to four names. 



STD 



Specifies the standard character arrangement table. JES3 uses the standard table specified 
at initialization. 

Note: STD is supported only on JES3 systems. 
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Defaults 



Overrides 



DUMP 

Requests a high-density dump of 204-character print lines from a 3800. If more than one 
table-name is coded, DUMP must be first. 

Note: DUMP is valid only on the OUTPUT JCL statement referenced in a SYSABEND 
or SYSUDUMP DD statement that specifies a sysout data set for the dump. 



If you do not code the OUTPUT JCL CHARS parameter, JES uses the following, in order: 

1. The DD CHARS parameter. 

2. The DD UCS parameter value, if coded. 

3. The OUTPUT JCL UCS parameter value, if coded. 

If no character-arrangement table is specified on the DD or OUTPUT JCL statements, JES 
uses an installation default specified at initialization. 



A CHARS parameter on the sysout DD statement overrides the OUTPUT JCL CHARS 
parameter. 

For a data set scheduled to the Print Services Facility (PSF), the PSF uses the following 
parameters, in override order, to select the font list: 

1. Font list in the library member specified by an OUTPUT JCL PAGEDEF parameter. 

2. DD CHARS parameter. 

3. OUTPUT JCL CHARS parameter. 

4. DD UCS parameter. 

5. OUTPUT JCL UCS parameter. 

6. JES installation default for the device. 

7. Font list on the PAGEDEF parameter in the PSF cataloged procedure. 
See "PAGEDEF Parameter" on page 17-48 for more information. 
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Requesting a High-Density Dump 

You can request a high-density dump on the 3800 through two parameters on the DD 
statement for the dump data set or on an OUTPUT JCL statement referenced by the dump DD 
statement: 

• FCB = STD3. This parameter produces dump output at 8 lines per inch. 

• CHARS = DUMP. This parameter produces 204-character print lines. 

You can code one or both of these parameters. You can place both on the same statement or 
one on each statement. 

Example of the CHARS Parameter 



//0UTDS2 OUTPUT CHARS= (GT12 ,GB12 ,GI12 ) 

In this example, the output from the 3800 will be printed in three upper and lower case fonts: 
GT12, Gothic 12-pitch; GB12, Gothic Bold 12-pitch; and GI12, Gothic Italic 12-pitch. 
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CKPTLINE Parameter 

Parameter Type: Keyword, optional 

Purpose: Use the CKPTLINE parameter to specify the maximum number of lines in a logical 
page. JES uses this value, with the CKPTPAGE parameter, to determine when to take 
checkpoints while printing the sysout data set or transmitting the systems network architecture 
(SNA) data set. 

Note: In a JES3 system, this parameter is supported when the Print Services Facility (PSF) 
prints the sysout data set on a 3800 Printing Subsystem Models 3 and 8. 

Syntax: 



CKPTLINE=nnnnn 



Subparameter Deflnition 



Lieiauits 



nnnnn 

Specifies the maximum number of lines in a logical page, nnnnn is a number from 
through 32767. 



If you do not code the CKPTLINE parameter, JES2 uses an installation default specified at 
initialization. JES3 provides no installation default. 



Example of the CKPTLINE Parameter 



//0UTDS3 OUTPUT CKPTLINE=4000 ,CKPTPAGE=5 

In this example, the sysout data set will be checkpointed after every 5 logical pages. Each 
logical page contains 4000 lines. 
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CKPTPAGE Parameter 



Parameter Type: Keyword, optional 

Purpose: Use the CKPTPAGE parameter to specify the number of logical pages: 

• To be printed before JES takes a checkpoint. 

• To be transmitted as a single systems network architecture (SNA) chain to an SNA work 
station before JES takes a checkpoint. 

The number of lines in these logical pages is specified in the CKPTLINE parameter. 

Note: In a JESS system, this parameter is supported when the Print Services Facility (PSF) 
prints the sysout data on a 3800 Printing Subsystem Models 3 and 8. 

Syntax: 



CKPTPAGE=nnnnn 



Subparameter Definition 



nnnnn 

Specifies the number of logical pages to be printed or transmitted before the next sysout 
data set checkpoint is taken, nnnnn is a number from 1 through 32767. 



Defaults 



If you do not code the CKPTPAGE parameter, JES2 uses an installation default specified at 
initialization; the default may also indicate whether checkpoints are to be based on page count 
or time. JES3 provides no installation default. 

Relationship to Other Parameters 

If you code both the CKPTPAGE and CKPTSEC parameters: 

• JES2 uses the value on the CKPTSEC parameter, provided the installation did not specify 
at initialization that checkpoints are to be based only on page count or time. 

• JES3 uses the value on the CKPTPAGE parameter. 
Example of the CKPTPAGE Parameter 

//0UTDS4 OUTPUT CKPTPAGE=128 , CKPTLINE=58 

. In this example, the sysout data set will be checkpointed after every 128 logical pages. Each 

1^ logical page, contains 58 lines. 
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CKPTSEC Parameter 

Parameter Type: Keyword, optional 

Purpose: Use the CKPTSEC parameter to specify how many seconds are to elapse between 
checkpoints of the sysout data set that JES is printing. 

Note: In a JESS system, this parameter is supported when the Print Services Facility (PSF) 
prints the sysout data set on a 3800 Printing Subsystem Models 3 and 8. 

Syntax: 



CKPTSEC=nnnnn 



Subparameter Deftnition 



nnnnn 

Specifies the number of seconds that is to elapse between checkpoints, nnnnn is a number 
from 1 through 32767. 



Defaults 



If you do not code the CKPTSEC parameter, JES2 uses an installation default specified at 
initialization; the default may also indicate whether checkpoints are to be based on page count 
or time. JES3 provides no installation default. 

Mdattonship to Other Parameters 

If you code both the CKPTPAGE and CKPTSEC parameters: 

® JES2 uses the value on the CKPTSEC parameter, provided the installation did not specify 
at initialization that checkpoints are to be based only on page count or time. 

• JESS uses the value on the CKPTPAGE parameter. 
Example of the CKPTSEC Parameter 

//0UTDS5 OUTPUT CKPTSEC=120 

In this example, the sysout data set will be checkpointed after every 120 seconds, or 2 minutes. 
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CLASS Parameter 



Parameter Type: Keyword, optional 

Purpose: Use the CLASS parameter to assign the sysout data set to an output class. 

Note: If a sysout data set has the same class as the JOB statement MSGCLASS parameter, the 
job log appears on the same output listing as the sysout data set. 

Syntax: 




Subparameter Definition 
class 



Identifies the output class for the data set. The class is one character: A through Z or 
through 9. The attributes of each output class are defined during JES initiaUzation; 
specify the class with the desired attributes. 

* 

Requests the output class in the MSGCLASS parameter on the JOB statement. 

Overrides 

The class subparameter of the DD statement SYSOUT parameter overrides the OUTPUT JCL 
CLASS parameter. On the DD statement, you must code a null class in order to use the 
OUTPUT JCL CLASS parameter; for example: 

//OUTDS DD SYSOUT=(, ) ,0UTPUT=*.0UT1 

Held Classes in a JES2 System 

The following topics describe held classes for different releases of JES2. 

JES2 1.3.4 (or Earlier) 

For mstallations running a JES2 L3.4 or earlier component: If SYSOUT specifies a class that is 
defined to JES2 as a held class, the sysout data set is held only if the JOB MSGCLASS 
parameter specifies (1) the same class as the SYSOUT parameter or (2) another class that is 
also defined to JES2 as a held class. 
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JES2 1.3.6 or 2.1.5 (or Later) 



For instaUations runnine a JES2 1.3.6 or 2.1.5 component or a s!ih«e«!!ent JES2 co!spe=e=t: An 

insiaiiaiion option ai J JtiSz initialization determines if both the class for the sysout data set and 
the class for the job's messages must be held in order for a sysout data set to be held. 

A sysout data set is held in the following cases: 

• The sysout DD statement contains HOLD = YES. 

• The sysout DD statement does not contain a HOLD parameter or contains HOLD = NO 
but requests a class that the installation defined as held and defined as: 

- Not requiring the message class to be a held class in order for the sysout data set to be 
held. The JOB statement MSGCLASS parameter can specify any class. 

- Requiring the message class to be a held class in order for the sysout data set to be 
held. The JOB MSGCLASS parameter must also specify a held class. 

A sysout data set is not held in the following cases: 

• The sysout DD statement does not contain a HOLD parameter or contains HOLD = NO 
and requests: 

- A class that the installation defined as not held. 

- A class that the installation defined as held and defined as requiring the message class 
to be a held class in order for the sysout data set to be held. The JOB MSGCLASS 
parameter must specify a class that is not held. 

Contact the installation to find out if holding the sysout class depends on a held MSGCLASS 
class. 



Significance of Output Classes 



To print this sysout data set and the messages from your job on the same output listing, code 
one of the following: 

• The same output class in the DD SYSOUT parameter as in the JOB MSGCLASS 
parameter. 

• DD SYSOUT = * to default to the JOB MSGCLASS output class. 

• DD SYSOUT = (,) to default to one of the following: 

1 , The CLASS parameter in an expUcitly or implicitly referenced OUTPUT" JCL 
statement. In this case, the OUTPUT JCL CLASS parameter should specify the same 
output class as the JOB MSGCLASS parameter, 

2. The JOB MSGCLASS output class, if no OUTPUT JCL statement is referenced or if 
the referenced OUTPUT JCL statement contains CLASS = *. 



M 



1 7-1 8 MVS/XA JCL Reference 



OUTPUT JCL: CLASS 

Examples of the CLASS Parameter 



//0UTDS6 OUTPUT CLASS=D 

//OUTl DD SYSOUT= { ,) , OUTPUT=* . 0UTDS6 

In this example, JES processes the sysout data set defined in DD statement OUTl in output 
class D. 

//PRINTALL JOB ACCT123 ,MAEBIRD,MSGCLASS=H 

//STEPl EXEC PGM=PRINTER 

//0UTDS7 OUTPUT CLASS=* 

//OUTPTR DD SYSOUT=( , ) ,OUTPUT=* .0UTDS7 

In this example, JES processes the sysout data set defined in DD statement OUTPTR in output 
class H, as specified in the JOB statement MSGCLASS parameter. The same result could be 
obtained by the following: 

//PRINTALL JOB ACCT123 ,MAEBIRD,MSGCLASS=H 
//STEPl EXEC PGM=PRINTER 
//OUTPTR DD SYSOUT=H 
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COMPACT Parameter 

Parameter Type: Keyword, optional 

Purpose: Use the COMPACT parameter to specify a compaction table for JES to use when 
sending the sysout data set, which is a systems network architecture (SNA) data set, to a SNA 
remote terminal. 

Syntax: 



COMPACT=compact ion-table-name 



Subparameter Definition 



compaction-table-name 

Specifies a compaction table by a symbolic name. The name is 1 through 8 alphanumeric 
characters. The symbolic name must be defined by the installation during JES 
initialization. 



Defaults 



If you do not code the COMPACT parameter, compaction is suppressed for the data set. 

Overrides 

This parameter overrides any compaction table value defined at the SNA remote terminal. 

Example of the COMPACT Parameter 



//0UTDS8 OUTPUT DEST=N555R222 ,COMPACT=TBL77 

In this example, the sysout data set will be sent to remote terminal 222 at node 555; JES will 
use compaction table TBL77. 
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CONTROL Parameter 



Parameter Type: Keyword, optional 

Purpose: Use the CONTROL parameter to specify either that each logical record starts with a 
carriage control character or that the output is to be printed with single, double, or triple 
spacing. 

Syntax: 



CONTROL= 


PROGRAM' 
SINGLE 
DOUBLE 
TRIPLE 





Subparameter Definition 



Defaults 



PROGRAM 

Indicates that each logical record in the data set begins with a carriage control character. 
The carriage control characters are given in Data Administration Guide. 

SINGLE 

Indicates forced single spacing. 

DOUBLE 

Indicates forced double spacing. 

TRIPLE 

Indicates forced triple spacing. 



If you do not code the CONTROL parameter, JES3 uses an installation default specified at 
initialization. 

In a JES2 system, an installation default can be provided for each local device by an operator 
command. 



Example of the CONTROL Parameter 



//0UTDS9 OUTPUT CONTROL=PROGRAM 

In this example, the sysout data set is printed using the first character of each logical record for 
carriage control. 
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COPIES Parameter 



Parameter Type: Keyword, optional 

Purpose: Use the COPIES parameter to specify how many copies of the sysout data set are to 
be printed. The printed output is in page sequence for each copy. 

For printing on a 3800 Printing Subsystem, this parameter can instead specify how many copies 
of each page are to be printed before the next page is printed. 

Syntax: 



COPIES= 



nnn 



( , (group-value [ , group-value] . . . ) ) 



You can omit the parentheses if you code only COPIES = nnn. 
The following are not vaHd: 

- A null group-value, for example, COPIES = (5,(,)) or COPIES = (5,) 

- A zero group-value, for example, COPIES = (5,(1,0,4)) 

- A null within a list of group-values, for example, COPIES = (5,(1 „4)) 



Subparameter Definition 



nnn 

Specifies how many copies of the sysout data set are to be printed; each copy will be in 
page sequence order, nnn is 1 through 3 decimal numbers from 1 through 255 in a JES2 
system and from 1 through 254 in a JES3 system. 

For a data set printed on a 3800, JES ignores nnn if any group values are specified. 

group-value 

Specifies how many copies of each page are to be printed before the next page is printed. 
Each group-value is I through 3 decimal numbers from 1 through 255 in a JES2 system 
and from 1 through 254 in a JES3 system. You can code a maximum of eight 
group-values. Their sum must not exceed 255 or 254. The total copies of each page 
equals the sum of the group-values. 

Note: 

• This subparameter is vahd only for 3800 output. 

• For 3800 output, this subparameter overrides an nnn subparameter, if coded. 
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Defaults 



If you do not code a COPIES parameter on any of the following, code it incorrectly, or code 
COPIES = 0, the system uses a default of 1 , which is the default for the DD COPIES parameter. 



Overrides 



DD statement 

OUTPUT JCL statement 

For JES2, the /*OUTPUT statement 



A COPIES parameter on the sysout DD statement overrides the OUTPUT JCL COPIES 

parameter. 

If the OUTPUT JCL statement contains a FORMDEF parameter, which specifies a library 
member, the COPYGROUP parameter on a FORMDEF statement in that member overrides 
any group-value subparameters on the OUTPUT JCL COPIES parameter or the sysout DD 
COPIES parameter. For more information, see "FORMDEF Parameter" on page 17-36. 



Relationship to Other Parameters 

If the OUTPUT JCL or the sysout DD statement contains a FLASH parameter, JES prints 
with the forms overlay the number of copies specified in one of the following: 

• COPIES = nnn, if the FLASH count is larger than nnn. For example, if COPIES = 10 and 
FLASH = (LTHD,12) JES prints 10 copies, all with the forms overlay. 

• The sum of the group-values specified in the COPIES parameter, if the FLASH count is 
larger than the sum. For example, if COPIES = (,(2,3,4) and FLASH = (LTHD, 12) JES 
prints nine copies in groups, all with the forms overlay. 

• The count subparameter in the FLASH parameter, if the FLASH count is smaller than nnn 
or the sum from the COPIES parameter. For example, if COPIES = 10 and 

FLASH = (LTHD,?) JES prints seven copies with the forms overlay and three copies 
without. 

Relationship to Other Control Statements 

For JES2, if you request copies of the entire job on the JES2 /*JOBPARM COPIES parameter 
and also copies of the data set on the DD COPIES or OUTPUT JCL COPIES parameter, JES2 
prints the number of copies equal to the product of the two requests. 
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Examples of the COPIES Parameter 



//RPTDS OUTPUT C0PIES=4 ,FORMS=WKREPORT 

This example asks JES to print four copies of the weekly report on forms named WKREPORT. 

//EXPLD OUTPUT COPIES= ( , ( 3 ) ) ,FORMS=ACCT 

This example asks JES to print the first page three times, then the second page three times, the 
third page three times, etc., on forms named ACCT. 

//QUEST OUTPUT COPIES= ( , (8 , 25 , 18 , 80) ) ,FORMS=ANS 

This example asks JES to print each page eight times before printing the next page, then 25 
times before the next, then 18 times before the next, and finally 80 times before the next. The 
forms are named ANS. 

//EXMP OUTPUT COPIES= (5, (3,2) ) 

This example asks JES to do one of the following: 

• If the data set is printed on other than a 3800, to print five copies. 

• If it is printed on a 3800, to print each page three times before printing the next page and 
then to print each page twice before printing the next page. 
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DEFAULT Parameter 



Parameter Type: Keyword, optional 

Purpose: Use the DEFAULT parameter to specify that this OUTPUT JCL statement can or 
cannot be implicitly referenced by a sysout DD statement. An OUTPUT JCL statement that 
contains a DEFAULT = YES parameter is called a default OUTPUT JCL statement. 



Syntax: 






DEFAULT= 


YES' 
Y 

NO 
N 





Subparameter Definition 
YES 



Defaults 



Indicates that this OUTPUT JCL statement can be implicitly referenced by sysout DD 
statements. This subparameter can also be coded as Y. 

NO 

Indicates that this OUTPUT JCL statement cannot be implicitly referenced by sysout DD 
statements. This subparameter can also be coded as N. 



If you do not code DEFAULT = YES, the default is NO. In order to take effect, an OUTPUT 
JCL statement without DEFAULT = YES must be explicitly referenced in an OUTPUT 
parameter on a sysout DD statement. 



Location in the JCL 



• A step-level OUTPUT JCL statement appears within a step, that is, anywhere after the first 
EXEC statement in a job. 

• A job-level OUTPUT JCL statement appears after the JOB statement and before the first 
EXEC statement. 

• You can place more than one job- or step-level default OUTPUT JCL statement in a job or 
step. 

• You must place an OUTPUT JCL statement in the input stream before any sysout DD 
statement that expUcitly or implicitly refers to it. 
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References to Default OUTPUT JGL Statements 



pux a.Jij.j.v bV/x uiaL opcwiiica 



the name of an OUTPUT JCL statement. 



• A sysout DD statement makes an implicit reference when it does not contain an OUTPUT 
parameter, and the job or step contains one or more default OUTPUT JCL statements. 

© A sysout DD statement implicitly references all step-level default OUTPUT JCL statements 
in the same step. 

• A sysout DD statement implicitly references all job-level default OUTPUT JCL statements 
when the step containing the DD statement does not contain any step-level default 
OUTPUT JCL statements. 

• A sysout DD statement can expUcitly reference a default OUTPUT JCL statement. 
Example of the DEFAULT Parameter 



//EXMP2 JOB ACCT555,MAEBIRD,MSGCLASS=B 

//OUTDAL OUTPUT DEFAULT=YES ,DEST=DALLAS 

//OUTPOK OUTPUT DEST=POK 

//STEPl EXEC PGM=REPORT 

//OUTHERE OUTPUT CLASS=D 

//SYSIN DD * 



/* 




//WKRPT 


DD 


//RPTl 


DD 


//RPT2 


DD 


//STEP2 


EXEC 


//OUTHQ 


OUTPUT 


//WKDATA 


DD 


//MONTH 


DD 


//SUM 


DD 


//FULRPT 


DD 



UNIT=VIO , DISP= ( , PASS ) 

S YSOUT= ( J , OUTPUT= * . OUTHERE 

SYSOUT=A 

PGM=SUMMARY 

DEFAULT=YES , DEST=HQ 

UNIT=VIO , DISP= ( OLD , DELETE ) , DSNAME=* . STEPl . WKRPT 

SYSOUT= {,) , OUTPUT=* . STEP 1 . OUTHERE 

SYSOUT=A 

S YSOUT=A , OUTPUT= ( * . OUTDAL , * . OUTPOK ) 



In this example, the JOB named EXMP2 contains two job-level OUTPUT JCL statements: 
OUTDAL and OUTPOK. OUTDAL is a default OUTPUT JCL statement because it contains 
DEFAULT = YES; OUTDAL can be implicitly referenced by a sysout DD statement. 
OUTPOK must be exphcitly referenced in a sysout DD OUTPUT parameter for its processing 
options to be used. The purpose of both of these OUTPUT JCL statements is to specify a 
destination for a sysout data set. 

STEPl contains a step-level OUTPUT JCL statement: OUTHERE. The purpose of this 
statement is to specify that JES process the data set locally in output class D. OUTHERE can 
be used only if it is explicitly referenced. 

STEP2 contains a step-level default OUTPUT JCL statement: OUTHQ. The purpose of this 
statement is to specify a destination for a sysout data set. OUTHQ can be implicitly 
referenced. 
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The references in this job are as follows: 

• In STEPl and STEP2, sysout DD statements RPTl and MONTH explicitly reference 
OUTPUT JCL statement OUTHERE. These two sysout data sets are printed locally in the 
same output class. 

Note: You can explicitly reference an OUTPUT JCL statement in a preceding job step. 

• In STEPl, DD statement RPT2 implicitly references OUTPUT JCL statement OUTDAL. 
This implicit reference occurs because all of the following are true: 

1. DD statement RPT2 contains a SYSOUT parameter but does not contain an OUTPUT 
parameter. Thus, this DD statement is making an implicit reference. 

2. STEPl does not contain a default OUTPUT JCL statement, so the implicit reference 
must be to job-level default OUTPUT JCL statements. 

3. OUTDAL is the only job-level default OUTPUT JCL statement. 

• In STEP2, DD statement SUM implicitly references OUTPUT JCL OUTHQ because all of 
the following are true: 

L DD statement SUM contains a SYSOUT parameter but does not contain an OUTPUT 
parameter. Thus, this DD statement is making an implicit reference. 

2. STEP2 contains a default OUTPUT JCL statement: OUTHQ. Therefore, the implicit 
reference is to OUTHQ and cannot be to any job-level default OUTPUT JCL 
statements. 

• In STEP2, DD statement FULRPT expUcitly references OUTPUT JCL statements 
OUTDAL and OUTPOK. 
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DEST Parameter 



Parameter Type: Keyword, optional 

Purpose: Use the DEST parameter to specify a destination for the sysout data set. The DEST 
parameter can send a sysout data set to a remote or local terminal, a node, a node and remote 
work station, a local device or group of devices, or a node and userid. 

Syntax: 



DEST=destination 

The destination subparameter for JES2 is one of the following: 

LOCAL 

name 

Nnnnn 

NnnRmmmm 

NnnnRmmm 

NnnnnRmm 

nodename . userid 

Rnnnn 

RMnnnn 

RMTnnnn 

Unnnn 

The destination subparameter for JESS is one of the following: 

ANYLOCAL 
device-name 
group -name 
nodename 
nodename . remote 
(type) 



Subparameter Definition for JES2 Systems 

LOCAL 

Indicates any local device. 



name 



Identifies a local or remote device by a symbolic name defined by the installation during 
JES2 initialization. The name is 1 through 8 alphanumeric or national characters. 

Nnnnn 

Identifies a node, nnnn is 1 through 4 decimal numbers from 1 through 1000. For 
example, Nil 03. 

NnnRmmmm 
NnnnRmmm 
NnnnnRmm 

Identifies a node and a remote work station connected to the node. The node number, 
indicated in the format by n, is 1 through 4 decimal numbers from 1 through 1000. The 
remote work station number, indicated in the format by m, is 1 through 4 decimal 
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numbers from 1 through 4000. Do not code leading zeros in n or m. The maximum 
number of digits for n and m combined cannot exceed six. 

Note: RO is equivalent to LOCAL specified at node Nn. 

nodename.userid 

Identifies a destination node and a TSO or VM userid at that node. Use this parameter 
to route a sysout data set between JES2 nodes and non-JES2 nodes. The nodename is a 
symbolic name defined by the installation during initialization; nodename is 1 through 8 
alphanumeric or national characters. The userid must be defined at the node; userid for 
TSO is 1 through 7 alphanumeric or national characters and for VM is 1 through 8 
alphanumeric or national characters. 

Note: If a data set is queued for transmission and an operator changes its destination, 
the userid portion of the original routing is lost. 

Rnnnn 

RMnnnn 

RMTnnnn 

Identifies a remote terminal, nnnn is 1 through 4 decimal numbers from I through 4000. 

Note: RO is equivalent to LOCAL. 

I Unnnn 

I Identifies a local terminal with special routing, nnnn is 1 through 4 decimal numbers 

I from 1 through 4000. 

Subparameter Definition for JES3 Systems 

ANYLOCAL 

Indicates any local device. 

device-name 

Identifies a local device by a symbolic name defined by the installation during JES3 
initialization, device-name is I through 8 alphanumeric or national characters. 

group-name 

Identifies a group of local devices, an individual remote station, or a group of remote 
stations by a symbolic name defined by the installation during JES3 initialization, 
group-name is 1 through 8 alphanumeric or national characters. 

nodename 

Identifies a node by a symboUc name defined by the installation during JES3 
initialization. The node is 1 through 8 alphanumeric or national characters. If the node 
you specify is the same as the node you are working on, JES3 treats the output as though 
you had specified LOCAL. 

nodename.remote 

Identifies a node and either a remote work station or VM userid at that node, as follows: 

nodename 

i A symbolic name defined by the installation during JES3 initialization. The 

^ nodename is I through 8 alphanumeric or national characters. 

Chapter 17. OUTPUT JCL Statement 1 7-29 



OUTPUT JCL: BEST 



Defaults 



remote 

A name for a remote work station. The name is 1 tiirough 8 alphanumeric or 
national characters and must be defined at the node Fticlose it in apostrophes 
when it contains special characters or begins with a number. 

(type) 

Identifies a device classification, type is in the form (gggssss), where ggg is the general 
device classification and ssss is the specific device classification; type must be enclosed in 
parentheses. The type must be defined by the installation during JESS initialization. For 
example, type for a 3800 is (PRT3800). 



If you do not code a DEST parameter, JES directs the sysout data set to the default destination 
for the input device from which the job was submitted. 



If a specified destination is invalid, the job fails. 



Overrides 



A DEST parameter on the sysout DD statement overrides the OUTPUT JCL DEST parameter. 
Examples of the DEST Parameter 

//REMOTl OUTPUT DEST=R444 

In this example, JES2 sends the sysout data set to remote terminal 444. 

//REM0T2 OUTPUT DEST=STAT444 

In this example, JES sends the sysout data set to an individual remote station named by the 
installation STAT444. 

//REM0T3 OUTPUT DEST=K0KVMBB8 .DP58HHHD 

In this example, JES sends the sysout data set to VM userid DP58HHHD at node 
KOKVMBB8. 
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FCB Parameter 



Parameter Type: Keyword, optional 
Purpose: Use the FCB parameter to specify: 

• The forms control buffer (FCB) image JES is to use to guide printing of the sysout data set 
by a 3211 Printer, 3203 Printer Model 5, 3800 Printing Subsystem, or 4248 Printer, or by a 
printer supported by systems network architecture (SNA) remote job entry (RJE). 

• The carriage control tape JES is to use to control printing of the sysout data set by a 1403 
Printer or by a printer supported by SNA RJE. 

• The data-protection image JES is to use to control output by a 3525 Card Punch. 

The FCB image specifies how many Unes are to be printed per inch and the length of the form. 
JES loads the image into the printer's forms control buffer. The FCB image is stored in 
SYSl.IMAGELIB. IBM provides three standard FCB images: 

• STDl, which specifies 6 Unes per inch on an 8.5-inch-long form. 

• STD2, which specifies 6 Unes per inch on an 11 -inch-long form, 

• STD3, which in a JES3 system specifies 8 lines per inch for a dump. 

References: For more information on the forms control buffer, see System-Data 
Administration, Programming Support for the IBM 3505 Card Reader and IBM 3525 Card 
Punch, or 3800 Printing Subsystem Programmer's Guide. 

Syntax: 



FCB= 



f cb-name 
STD 



• Code the fcb-name as STDl or STD2 only to request the IBM-supplied images. 

• Code the fcb-name as STD3 only for a high-density dump in a JES3 system. 



Subparameter Definition 

fcb-name 

Identifies the FCB image. The name is 1 through 4 alphanumeric or national characters 
and is the last characters of a SYSl.IMAGELIB member name: 

• FCB2xxxx member, for a 3211, a 3203 model 5, or a printer supported by SNA, 

• FCB3xxxx member, for a 3800, 

• FCB4xxxx member, for a 4248. 

STD 

Indicates the standard FCB. JES3 uses the standard FCB specified at JES3 initialization. 

s' Note: STD is supported only on JES3 systems. 
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Defaults 



Overrides 



If you do not cede the FCB parameter, the system checks the FCB iiuagc In the printer's forms 
control buffer; if it is a default image, as indicated by its first byte, JES uses it. If it is not a 
default image, JES loads the FCB image that is the installation default specified at JES 
initiaUzation. 



An FCB parameter on the sysout DD statement overrides the OUTPUT JCL FCB parameter. 



Requesting a High-Density Dump 



You can request a high-density dump on the 3800 through two parameters on the DD 
statement for the dump data set or on an OUTPUT JCL statement referenced by the dump DD 
statement: 

• FCB = STD3. This parameter produces dump output at 8 lines per inch. 

• CHARS = DUMP. This parameter produces 204-character print Unes. 

You can code one or both of these parameters. You can place both on the same statement or 
one on each statement. 



Kxamiile of the FCB Parameter 



//OUTDSl OUTPUT FCB=AA33 

In this example, JES will print the sysout data set using the FCB image named AA33. 
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FLASH Parameter 



Parameter Type: Keyword, optional 

Purpose: Use the FLASH parameter to identify the forms overlay to be used in printing the 
sysout data set on a 3800 Printing Subsystem and, optionally, to specify the number of copies 
on which the forms overlay is to be printed. 

Note: FLASH is valid only for a data set printed on a 3800. 

References: For information on forms overlays, see the Forms Design Reference Guide for the 
IBM 3800 Printing Subsystem, 



Syntax: 



overlay-name 
FLASH= ( overlay-name [ , count ] ) 
( ( , count) 
NONE 
STD 



The count subparameter is optional. If you omit it, you can omit the parentheses. However, 
if you omit it, you must not code it as a null; for example, FLASH = (ABCD,) is invalid. 



Subparameter Definition 



overlay-name 

Identifies the forms overlay frame that the operator is to insert into the printer before 
printing begins. The name is 1 through 4 alphanumeric or national characters. 

count 

Specifies the number, through 255, of copies that JES is to flash with the overlay, 
beginning with the first copy printed. Code a count of to flash no copies. 

NONE 

Suppresses flashing for this data set. 

If FLASH = NONE is on an OUTPUT JCL statement in a job to be executed at a remote 
node, JES3 sets the overlay-name to zero before sending the job to the node. 



STD 



Indicates the standard forms flash overlay. JES3 uses the standard forms overlay 
specified at JES3 initialization. 

Note: STD is supported only on JES3 systems. 



Chapter 17. OUTPUT JCL Statement 17-33 



OUTPUT JCL: FLASH 

Defaults 



If you do not code a FLASH parameter or specify an instalhtic: 
initialization, forms are not flashed. 






Overrides 



If you specify an overlay-name without specifying a count, all copies are flashed. That is, the 
default for count is 255. 



A FLASH parameter on the sysout DD statement overrides the OUTPUT JCL FLASH 
parameter. 



Relationship to Other Parameters 

If the OUTPUT JCL or the sysout DD statement also contains a COPIES parameter, JES 
prints with the forms overlay the number of copies specified in one of the following: 

• COPIES = nnn, if the FLASH count is larger than nnn. For example, if COPIES = 10 and 
FLASH = (LTHD, 12) JES prints 10 copies, all with the forms overlay. 

• The sum of the group-values specified in the COPIES parameter, if the FLASH count is 
larger than the sum. For example, if COPIES = (,(2,3,4)) and FLASH = (LTHD,I2) JES 
prints nine copies in groups, all with the forms overlay. 

• The count subparameter in the FLASH parameter, if the FLASH count is smaller than nnn 
or the sum from the COPIES parameter. For example, if COPIES = 10 and 

FLASH = (LTHD,7) JES prints seven copies with the forms overlay and three copies 
without. 

Verification of Forms Overlay Frame 

Before printing starts, JES does not verify that the operator inserted the correct forms overlay 
frame for flashing. 

Printing without Flashing 

To print without flashing, specify one of the following: 

• FLASH = NONE on the DD or OUTPUT JCL statement. 

• Omit the FLASH parameter on all of the statements for the data set and on all JES 
initialization statements. 

• FLASH = (,0) on the OUTPUT JCL statement. 



17-34 MVS/XA JCL Reference 



OUTPUT JCL: FLASH 

Example of the FLASH Parameter 



//OUTDSl OUTPUT C0PIES=16 ,FLASH= (LTHD, 7 ) 

In this example, JES issues a message to the operator requesting that the forms overlay frame 
named LTHD be inserted in the printer. Then JES prints the first seven copies of the sysout 
data set with the forms overlay and the last nine without. 
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FORMDEF Parameter 

Parameter Type: Keyword, optional 

Purpose: Use the FORMDEF parameter to identify a library member that contains statements 
to tell the Print Services Facility (PSF) how to print the sysout data set on a 3800 Printing 
Subsystem Model 3. The statements can specify the following: 

• Overlay forms to be used during printing. 

• Location on the page where overlays are to be placed. 

• Suppressions that can be activated for specified page formats. 

The member must be in the library named in the cataloged procedure that was used to initiaUze 
the PSF. 

Note: FORMDEF can be specified only for data sets printed on a 3800 model 3. 

References: For more information, see Print Management Facility User's Guide and Reference 
and 3800 Printing Subsystem Programmer's Guide. 

Syntax: 




Subparameter DeHnition 



Overrides 



membername 

Specifies the name of a library member, membername is 1 through 6 alphanumeric or 
national characters; the first two characters are pre-defined by the system. 



The library member specified by the OUTPUT JCL FORMDEF parameter can contain: 

• Statements that override the installation's FORMDEF defaults in the PSF cataloged 
procedure. 

• A FORMDEF statement with a COPYGROUP parameter. The COPYGROUP parameter 
overrides any group- value subparameters on the OUTPUT JCL COPIES parameter or the 
sysout DD COPIES parameter. 

Note: The FORMDEF statement in the library member does not override a sysout DD or 
OUTPUT JCL COPIES = nnn parameter. 
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Example of the FORMDEF Parameter 



//PRINT 3 OUTPUT FORMDEF=JJPRT 

In this example, PSF is to print the sysout data set on a 3800 model 3 according to the 
parameters in the library member JJPRT. 
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OUTPUT JCL: FORMS 



FORMS Parameter 



Parameter Type: Keyword, optional 

Purpose: Use the FORMS parameter to identify the forms on which the sysout data set is to 
be printed or punched. 

Syntax: 



FORMS= 


form-name 
STD 





Subparameter Definition 



Defaults 



Overrides 



form-name 

Identifies the print or punch forms, form-name is 1 through 8 alphanumeric or national 
characters. 

STD 

Indicates that JES3 is to use the standard form specified at JES3 initialization. 

Note: STD is supported only on JES3 systems. 



If you do not code a form-name subparameter, JES uses an installation default specified at 
initialization. 



The form-name subparameter of the SYSOUT parameter on the sysout DD statement overrides 
the OUTPUT JCL FORMS parameter. Note that the SYSOUT form-name subparameter can 
be only four characters maximum while both the OUTPUT JCL FORMS form-name and the 
JES initialization default form names can be eight characters maximum. 



Example of the FORMS Parameter 



//OUTDSl OUTPUT F0RMS=ACCT4010 

In this example, the sysout data set will be printed on forms named ACCT4010. 
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GROUPID Parameter 



Parameter Type: Keyword, optional, JES2 only 

Purpose: Use the GROUPID parameter to specify that the sysout data set belongs to an 
output group. The data sets in an output group are processed together in the same location 
and time. Data sets to be grouped should have similar characteristics: the same output class, 
destination, process mode, and external writer name. 

Note: GROUPID is supported only on JES2 systems. 

Syntax: 



GROUPID=output-group 



Subparameter Definition 

output-group 

Specifies the name of an output group. The output-group is 1 through 8 alphanumeric 
characters and is selected by the programmer to define an output group for this job. The 
name is not installation-defined. 

Relationship to Other Control Statements 

If you code FREE = CLOSE on a sysout DD statement that references an OUTPUT JCL 
statement containing a GROUPID parameter, JES2 will not group the data sets into one 
output group. Instead, JES2 produces one copy of the sysout data set for each OUTPUT JCL 
statement that the DD statement references. 
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Examples of the GROUPID Parameter 



//EXMP5 JOB 
//OUTRPT OUTPUT 
//STEPl EXEC 
//SYSIN DD 



ACCT1984 , MAEBIRD , MSGCLASS=A 

GROUPID=RPTGP , DEFAULT=YES , DEST=TDC 

PGM=RPTWRIT 
* 



/* 

//RPTDLY DD 
//RPTWK DD 



SYSOUT=C 
SYSOUT=C 



In this example, the DD statements RPTDLY and RPTWK implicitly reference the default 
OUTPUT JCL statement OUTRPT. JES2 creates two output groups: 

1. Group RPTGP is created because of the GROUPID parameter in the OUTPUT JCL 
statement. It contains the two reports from the sysout DD statements RPTDLY and 
RPTWK and is printed at the destination TDC. The programmer named this group 
RPTGP. 

2. The other group is named by JES2. It contains the system-managed data set for the job's 
messages. 



//EXAMP 


JOB 


//JOBOuT 


UUTFUT 


//STEPl 


EXEC 


//OUTl 


OUTPUT 


//RPTl 


DD 


//STEP2 


EXEC 


//0UT2 


OUTPUT 


//RPT2 


DD 



MSGCLASS=A 

GROUPID=SUMM , DEST=HQS , CHARS=GT10 

PGM=RWRITE 

FORMS=STD , CHARS=GS 10 , DEST=LOCAL 

SYSOUT=A , OUTPUT= ( * . OUTl , * . JOBOUT ) 

PGM=SWRITE 

FORMS= 1 1 1 , CHARS=GB 10 , DEST=LOCAL 

SYSOUT=B , OUTPUT= ( * . 0UT2 , * . JOBOUT ) 



This job causes JES2 to produce five sets of output: 

1.1.1, containing the system-managed data sets. This set is specified through the JOB 
statement MSGCLASS parameter. 

SUMM.1.1, containing a copy of the data set defined by DD statement RPTl. This set is 
specified through the second OUTPUT subparameter: *. JOBOUT. It is for output class 
A. 

SUMM.2.1, containing a copy of the data set defined by DD statement RPT2. This set is 
specified through the second OUTPUT subparameter: *. JOBOUT. Because it is for 
output class B, it is in a separate subgroup from the SUMM.1.1 subgroup. 

4.1.1, containing a copy of the data set defined by DD statement RPTl. This set is 
specified through the first OUTPUT subparameter: *.OUTl. 

5.1.1, containing a copy of the data set defined by DD statement RPT2. This set is 
specified through the first OUTPUT subparameter: *.OUT2. 
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OUTPUT JCL: INDEX 



INDEX Parameter 



Parameter Type: Keyword, optional, JES2 only 

Purpose: Use the INDEX parameter to set the left margin for output on a 321 1 Printer with 
the indexing feature. The width of the print line is reduced by the INDEX parameter value. 

Note: INDEX is supported only on JES2 systems and only for output printed on a 321 1 with 
the indexing feature. JES2 ignores the INDEX parameter if the printer is not a 321 1 with the 
indexing feature. 

Syntax: 



INDEX=nn 



Subparameter Definition 



Defaults 



nn 

Specifies how many print positions the left margin on the 3211 output is to be indented, 
nn is a decimal number from 1 through 31. n= 1 indicates flush-left; n = 2 through n = 31 
indent the print line by n-1 positions. 



The default is 1, which indicates flush left. Thus, if you do not code an INDEX or LINDEX 
parameter, JES2 prints full-width lines. 

Relationship to Other Parameters 

INDEX and LINDEX are mutually exclusive; if you code both, JES2 uses the last one 
encountered. Note that you cannot index both the left and right margins. 

Example of the INDEX Parameter 



//0UT17 OUTPUT INDEX=6 

In this example, because the printed report is to be stapled, extra space is needed on the left. 
Assuming the data set is printed on a 3211 with the indexing feature, all Mnes are indented 5 
print positions from the left page margin. 
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OUTPUT JCL: JESDS 
JESDS Parameter 

Parameter Typei Keyword, optional 

Purpose: Use the JESDS parameter to process the job's system-managed data sets according to 
the parameters on this OUTPUT JCL statement. The system-managed data sets consist of: 

• The job log, which is a record of job-related information for the programmer. Printing of 
the job log is controlled by two JOB statement parameters: the MSGLEVEL parameter 
controls what is printed and the MSGCLASS parameter controls the system output class. 

• The job's hard-copy log, which is a record of all message traffic for the job to and from the 
operator console. 

• System messages for the job. 

The class for the system-managed data sets is, in override order, (1) the class specified in the 
JOB statement MSGCLASS parameter or (2) the class in the CLASS parameter on the 
OUTPUT JCL statement containing JESDS. 

References: For more information on the job log, see System Commands. 

Syntax: 




Subparameter Definition 
ALL 



Indicates all of the job's system-managed data sets. 

JCL 

Indicates all job control statements in the input stream, that is, all JCL statements and 
JES2 or JES3 statements, plus all procedure statements from any in-stream or cataloged 
procedure a job step calls, plus all messages about job control statements. 

LOG 

Indicates the job's hard-copy log, which contains the JES and operator messages about 
the job's processing: allocation of devices and volumes, execution and termination of job 
steps and the job, and disposition of data sets. 

MSG 

Indicates any system messages for this job. 
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Overrides 

The NOLOG parameter on a JES2 /*JOBPARM statement overrides the OUTPUT JCL 
JESDS = ALL parameter. 

Location in the JCL 

Place an OUTPUT JCL statement containing JESDS before the first EXEC statement of the 
job. An OUTPUT JCL statement containing JESDS placed after an EXEC statement is a JCL 
error. 

You can place more than one OUTPUT JCL statement containing JESDS before the first 
EXEC statement. JES creates a copy of the job's system data sets for each. 

Destination for the System Data Sets 

If you want the job's system data sets processed at a particular destination, code a DEST 
parameter on the OUTPUT JCL statement containing JESDS. Otherwise, JES routes the 
system data sets to a local device. 

JES2 Processing with JESDS 

JES2 processes OUTPUT JCL statements for system-managed data sets (JESDS parameter) 
only if a job completes execution. 

System-managed data sets are not processed for the following jobs because the jobs do not 
complete execution: 

• Jobs that specify a TYPRUN value on the JOB statement that prevents execution, such as 
COPY or SCAN. 

• Jobs that do not execute because of a JCL error, an error in a JES2 control statement, or a 
system failure in JES2 input processing. 

• Jobs that reach execution but do not complete execution because an MVS system failure 
occurs that requires an IPL. 

Example of the JESDS Parameter 



//EXMP JOB MSGCLASS=A 

//OUTl OUTPUT JESDS=ALL 

//0UT2 OUTPUT JESDS=ALL,DEST=AUSTIN 



In this example, JES produces two copies of the system-managed data sets: one copy for 
OUTPUT JCL statement OUTl and one copy for OUTPUT JCL statement OUT2. The copy 
for statement OUT2 is sent to AUSTIN. 
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OUTPUT JCL: LINDEX 



LINDEX Parameter 



Parameter Type: Keyword, optional, JES2 only 

Purpose: Use the LINDEX parameter to set the right margin for output on a 3211 Printer 
with the indexing feature. The width of the print hne is reduced by the LINDEX parameter 
value. 

Note: LINDEX is supported only on JES2 systems and only for output printed on a 3211 with 
the indexing feature. JES2 ignores the LINDEX parameter if the printer is not a 321 1 with the 
indexing feature. 

Syntax: 



LINDEX=nn 



Subparameter Definition 



Defaults 



nn 

Specifies how many print positions the right margin on the 321 1 output is to be moved in 
from the full page width= nn is a decimal number from 1 through 31. n= 1 indicates 
flush-right; n = 2 through n = 31 move the right margin over by n-1 positions. 



The default is 1, which indicates flush right. Thus, if you do not code an INDEX or LINDEX 
parameter, JES2 prints full-width lines. 

Relationship to Other Parameters 

INDEX and LINDEX are mutually exclusive; if you code both, JES2 uses the last one 
encountered. Note that you cannot index both the left and right margins. 

Example of the LINDEX Parameter 



//OUTIS OUTPUT LINDEX==21 

In this example, the author of the report wanted extra space on the right side of the paper for 
notes. Assuming the data set is printed on a 321 1 with the indexing feature, all lines are ended 
20 print positions from the right page margin. 
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OUTPUT JCL: LINECT 



LINECT Parameter 



Parameter Type: Keyword, optional, JES2 only 

Purpose: Use the LINECT parameter to specify the maximum number of lines JES2 is to print 
on each output page. 

Note: LINECT is supported only on JES2 systems. 

Syntax: 



LINECT=nnn 



Subparameter Definition 
nnn 



Defaults 



Specifies the maximum number of lines JES2 is to print on each page, nnn is a number 
from through 255. 

Specify LINECT = to keep JES2 from starting a new page when the number of lines 
exceeds the JES2 initialization parameter. 



If you do not code the LINECT parameter, JES2 obtains the value from one of the following 
sources, in order: 

1. The linect field of the accounting information parameter on the JOB statement. 

2. The installation default specified at JES2 initialization. 



Example of the LINECT Parameter 



//PRNTDS OUTPUT LINECT=45 

In this example, JES2 will start a new page after every 45 lines. 
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OUTPUT JCL: MODIFY 



MODIFY Parameter 



Parameter Type: Keyword, optional 

Purpose: Use the MODIFY parameter to specify a copy-modification module that tells JES 
how to print the sysout data set on a 3800 Printing Subsystem. The module can specify the 
following: 

• Legends. 

• Column headings. 

• Where and on which copies the data is to be printed. 

The module is defined and stored in SYSl.IMAGELIB using the lEBIMAGE utility program. 

Note: MODIFY is supported only for the 3800 Printing Subsystem Model 1 and 2 and the 
3800 Printing Subsystem Model 3 in compatibility mode. For the 3800 model 3, use the 
FORMDEF and PAGEDEF parameters to obtain the same functions. 

References: For more information on the copy modification module and the lEBIMAGE 
utility program, see Data Administration: Utilities. 

Syntax: 



MODIFY= 



module --name 

( [module-name] [ ,trc] ) 



You can omit the module-name, thereby obtaining the initialization default. For 
example, MODIFY = (,2). 

The trc subparameter is optional. If you omit it, you can omit the parentheses. 
However, if you omit it, you must not code it as a null; for example, 
MODIFY = (TAB 1 ,) is invalid. 



Subparameter Definition 



module-name 

Identifies a copy-modification module in SYSl.IMAGELIB. The module-name is 1 
through 4 alphanumeric or national characters. 
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Defaults 



OUTPUT JCL: MODIFY 

trc 

Identifies which table-name in the CHARS parameter is to be used. This table reference 
character is for the first table-name specified, 1 for the second, 2 for the third, or 3 for 
the fourth. The CHARS parameter used is on the following, in override order: 

1. The DD statement. 

2. This OUTPUT JCL statement. 

3. A statement in the library member specified on the OUTPUT JCL PAGEDEF 
parameter. 

4. A statement in the SYSl.IMAGELIB member obtained by default. 

5. A JES3 initialization statement. 



If you do not code module-name in the MODIFY parameter, JES3 uses an installation default 
specified at initiahzation. JES2 provides no installation default at initialization. 

If you do not specify trc, the default is 0. If the trc value is greater than the number of 
table-names in the CHARS parameter, JES2 uses the first table named in the CHARS 
parameter and JES3 uses the default character arrangement table. 



A MODIFY parameter on the sysout DD statement overrides the OUTPUT JCL MODIFY 

parameter. 

Relationship to Other Parameters 

The second character of each logical record can be a TRC code, so that each record can be 
printed in a different font. This way of specifying fonts is indicated by the OUTPUT JCL TRC 
parameter. 

Example of the MODIFY Parameter 



//OUTDSl OUTPUT CHARS= (GT12 ,GB12 ,GI12 ) ,MODIFY= (MODA, 2 ) 

In this example, JES loads the MODA module in SYSl.IMAGELIB into the 3800 and uses 
Gil 2, Gothic ItaUc 12-pitch font, which is the third table name specified in the CHARS 
parameter. 



Overrides 
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PAGEDEF Parameter 

Parameter Type: Keyword, optional 

Purpose: Use the PAGEDEF parameter to identify a library member that contains statements 
to tell the Print Services Facility (PSF) how to print the sysout data set on a 3800 Printing 
Subsystem Model 3. The statements can specify the following: 

• Logical page length and width. 

• Fonts. 

© Page segments. 

• Multiple page types or formats. 

• Lines within a page; for example: 

- Line origin. 

- Carriage controls. 

- Spacing. 

• Multiple logical pages on a physical page. 

The member must be in the library named in the cataloged procedure that was used to initialize 
the PSF. 

Note: PAGEDEF can be specified only for data sets printed on a 3800 model 3. 

References: For more information, see Print Management Facility User's Guide and Reference 
and 3800 Printing Subsystem Programmer's Guide. 

Syntax: 




Subparameter Definition 



membername 

Specifies the name of the hbrary member, membername is 1 through 6 alphanumeric or 
national characters; the first two characters are pre-defined by the system. 
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Overrides 



The statements in the library member specified by the OUTPUT JCL PAGEDEF parameter 
override the installation's PAGEDEF defaults in the PSF cataloged procedure. 

The PSF uses the following parameters, in override order, to select the font list: 

1. Font list in the Ubrary member specified by an OUTPUT JCL PAGEDEF parameter. 

2. DD CHARS parameter. 

3. OUTPUT JCL CHARS parameter. 

4. DD UCS parameter. 

5. OUTPUT JCL UCS parameter. 

6. JES installation default for the device. 

7. Font list on the PAGEDEF parameter in the PSF cataloged procedure. 

Example of the PAGEDEF Parameter 



//OUTDSl OUTPUT PRMODE=PAGE ,PAGEDEF=SSPGE 

In this example, PSF is to print the sysout data set on a 3800 model 3 operating in page mode. 
The printing is to be done according to the parameters in the library member SSPGE. 
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OUTPUT JCL: PIMSG 



PIMSG Parameter 



Parameter Type: Keyword, optional 

Purpose: Use the PIMSG parameter to indicate that messages from a functional subsystem 
should or should not be printed in the output listing following the sysout data set created by the 
functional subsystem. 

The functional subsystem. Print Services Facility (PSF), accumulates messages in the PSF 
address space for errors that occur (1) while processing Hne-mode data when PAGEDEF is 
specified and (2) while processing page-mode data. The system prints these messages at the end 
of the sysout data set, unless you code PIMSG = NO. 

Note: PIMSG can be specified only for data sets printed on a 3800 Printing Subsystem Models 
3 and 8. 



Syntax: 






PIMSG= 


(YES) 
Y 

NO 
N 





i!>uwp<u auicici J-/C1I1UIIU11 



Defaults 



YES 

Requests that the system print the messages generated by a functional subsystem. This 
subparameter can also be coded as Y. 

NO 

Requests that the system not print the messages generated by a functional subsystem. 
This subparameter can also be coded as N. 



If you do not code the PIMSG parameter and the sysout data set is printed by the PSF on a 
3800 model 3, the default is YES. 



Example of the PIMSG Parameter 



//DS17 OUTPUT PRMODE=PAGE,PAGEDEF=H7MEM2,PIMSG=NO 

In this example, PSF prints the sysout data set on a 3800 model 3 operating in page mode. 
PSF processes the data set according to the statements in hbrary member H7MEM2. The 
output does not contain PSF messages. 
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PRMODE Parameter 



Parameter Type: Keyword, optional 

Purpose: Use the PRMODE parameter to identify the process mode required to print the 
sysout data set. JES schedules the data set to a printer that can operate in the specified mode. 

In a JES2 system, you can specify any of the modes that the installation defined during JES2 
initialization. A JES2 installation can specify up to four modes for each device. 

In a JES3 system, you can specify only LINE or PAGE. 

Syntax: 



PRMODE= 



LINE 
PAGE 
process-mode 



Subparameter Definition 

LINE 



Defaults 



Indicates that the data set is to be scheduled to a line-mode printer. 

PAGE 

Indicates that the data set is to be scheduled to a page-mode printer. 

process-mode 

Specifies the required process mode. The process-mode is I through 8 alphanumeric 
characters and must have been specified during JES2 initialization. 

For an NJE-transmitted data set, use PRMODE to request specific processing without 
having to obtain output classes for the node that processes the data set. 

Note: The process-mode subparameter is supported only on JES2 systems. 



If you do not code the PRMODE parameter, JES schedules output processing as follows: 

• If the sysout data set does not contain page-mode formatting controls, to a printer with a 
process mode of line. 

• If the sysout data set contains page-mode formatting controls, to any printer with a process 
mode of page. 
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Printing a Line-Mode Data Set Using PSF 

To print a line-mode data set using the Print Services Facility (PSF) and the enhanced 
capabilities of the 3800 model 3, code PRMODE = PAGE. The PSF formats this line-mode 
data set using the installation's default values for PAGEDEF and FORMDEF defined in the 
PSF cataloged procedure; if these defaults are unsatisfactory, code the PAGEDEF and 
FORMDEF parameters on the OUTPUT JCL statement. 

Example of tlie PRMODE Parameter 



//DS18 OUTPUT PRMODE=LINE 

In this example, JES schedules the sysout data set to a printer with a process mode of line. 
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PRTY Parameter 



Parameter Type: Keyword, optional 

Purpose: Use the PRTY parameter to specify the priority at which the sysout data set enters 
the output queue. A data set with a higher priority is printed sooner. 

Syntax: 



PRTY=nnn 



Subparameter Definition 



Defaults 



Overrides 



nnn 

Specifies the initial priority, nnn is a decimal number from through 255; is the lowest 
priority while 255 is the highest. 



If you do not code the PRTY parameter, JES3 uses an installation default specified at 
initialization. JES2 uses a priority that is calculated for all output. 



In JES2 systems, the installation can specify at JES2 initialization that JES2 is to ignore the 
OUTPUT JCL PRTY parameter. 



Example of the PRTY Parameter 



//PRESRPT OUTPUT PRTY=200 ,FORMS=TOPSEC 

In this example, JES prints one copy of the president's report, PRESRPT, on forms named 
TOPSEC. Because a priority of 200 is specified, the report is probably printed immediately 
after entering the-output queue. 
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THRESHLD Parameter 

Parameter Type: Keyword, optional, JES3 only 

Purpose: Use the THRESHLD parameter to specify the maximum size for the sysout data set. 
JES3 calculates the sysout data set size as the number of records multiplied by the number of 
copies requested. When this size exceeds the THRESHLD value, JES3 creates a new unit of 
work, on a data set boundary, and queues it for printing. Consequently, copies of the sysout 
data set may be printed simultaneously by different printers. 

Use the THRESHLD parameter for jobs that generate many large data sets or many copies of 
one large data set. 

Note: THRESHLD is supported only on JESS systems. 

Syntax: 



THRESHLD^ limit 



Subparameter Definition 
limit 



Defaults 



Specifies the maximum number of records for a single sysout data set. limit is a decimal 
number from 1 through 99999999. 



If you do not code the THRESHLD parameter, JES3 uses an installation default specified at 
initialization. 
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Example of the THRESHLD Parameter 



//STEP A EXEC PGM=RPTWRT 

//SYSDS3 OUTPUT DEFAULT=YES ,THRESHLD=10000 

//RPTl DD SySOUT=A,COPIES=10 

//RPT2 DD SyS0UT=A,C0PIES=2 

//RPT3 DD SYS0UT=A,C0PIES=5 

In this example, the report data sets, RPTl, RPT2, and RPT3, are processed in sysout class A. 
All three DD statements implicitly reference the step-level default OUTPUT JCL statement 
SYSDS3; therefore, the THRESHLD value specified in the OUTPUT JCL statement applies to 
the three reports combined. JES3 is to print the following: 





Data 


Records in 


Total 


!opies 


Set 


Data Set 


Records 


10 


RPTl 


1000 


10000 


2 


RPT2 


2000 


4000 


5 


RPT3 


500 


2500 



Total 16500 

Because the total exceeds the THRESHLD limit, JESS divides the sysout data sets into two 
units of work. RPTl is printed as one unit, and the other two data sets are printed together as 
another unit. If the THRESHLD limit had been 20000, all three data sets would have been 
printed as one unit of work. 
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TRC Parameter 



Parameter Type: Keyword, optional 

Purpose: Use the TRC parameter to specify whether the logical record for each output line in 
the sysout data set contains table reference character (TRC) codes or not. The TRC code 
identifies which table-name in the CHARS parameter is to be used to print the record. 

If present, a IRC code in the output hne record is: 

• The first byte, if a control character is not used. 

• The second byte, immediately following the control character, if used. 

Note: TRC is supported only on JES3 systems. However, in a JES2 system, TRC can be 
specified for a data set processed in a functional subsystem address space (FSA); JES2 passes 
the TRC parameter value to the FSA. Thus, TRC can be specified for a data set printed on a 
3800 Printing Subsystem Model 3 by the Print Services FaciHty (PSF). 

Syntax: 



TRC= 


rYES) 




Y 




NO 
N 



Subparameter Definition 

YES 



Defaults 



Indicates that the data set contains TRC codes. This subparameter can also be coded as 

Y. 

NO 

Indicates that the data set does not contain TRC codes. This subparameter can also be 
coded as N. 



If you do not code the TRC parameter, the default is NO. 



Relationship to Other Parameters 



A table reference character for the entire data set can be specified in the OUTPUT JCL 
MODIFY parameter. 
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Example of the TRC Parameter 



//WRTR JOB ACN077,MAEBIRD,MSGCLASS=B 

//DS23 OUTPUT DEFAULT=YES,FORMS=STD,CONTROL=PROGRAM,TRC=YES 

//STEPl EXEC PGM=DLYRPT 

//DAILY DD SYSOUT=A,CHARS=(GT12,GB12,GI12) 

In this example, sysout DD statement DAILY implicitly references the default job-level 
OUTPUT JCL statement DS23. This OUTPUT JCL statement directs JES3 to print the daily 
report on standard forms. The sysout data set defined by DD statement DAILY contains 
carriage control characters in the first character of each logical record and a TRC code in the 
second character. The TRC characters in the records are to use the font GT12; 1 to use 
GB12; and 2 to use GI12. 



Chapter 17. OUTPUT JCL Statement 17-57 



OUTPUT JCL: UCS 



UCS Parameter 



Parameter Type: Keyword, optional 
Purpose: Use the UCS parameter to identify: 

• The universal character set (UCS) image JES is to use in printing the sysout data set. 

• A print train (print chain or print band) JES is to use in printing the sysout data set on an 
impact printer. 

• A character-arrangement table for the sysout data set printed on a 3800 Printing Subsystem 
in a JES2 system. In this use, the UCS parameter acts Hke a CHARS parameter. 

The UCS image specifies the special character set to be used. JES loads the image into the 
printer's buffer. The UCS image is stored in SYSl.IMAGELIB. IBM provides the special 
character set codes in Figure 17-2. 

References: For more information on the UCS parameter, see System-Data Administration. 

Syntax: 



UCS=character-set-code 



Subparameter Definition 



character-set-code 

Identifies a universal character set. The character-set-code is 1 through 4 alphanumeric or 
national characters. See Figure 17-2 for IBM standard special character set codes. 



Defaults 



If you do not code the UCS parameter, the system checks the UCS image in the printer's 
buffer; if it is a default image, as indicated by its first byte, JES uses it. If it is iiot a default 
image, JES loads the UCS image that is the installation default specified at JES initiahzation. 

On an impact printer, if the chain or train does not contain a valid character set, JES asks the 
operator to specify a character set and to mount the corresponding chain or train. 
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Overrides 



1403 


3203 
Models 


3211 


Characteristics 


AN 
HN 

PCAN 
PCHN 

PN 
QN 
QNC 
RN 

SN 
TN 
XN 
YN 


AN 
HN 

PCAN 

PCHN 

PN 

QN 

QNC 

RN 

SN 

TN 


All 
Hll 
Gil 

Pll 
Til 


Arrangement A, standard EBCDIC character set, 48 characters 

Arrangement H, EBCDIC character set for FORTRAN and COBOL, 48 characters 

ASCII character set 

Preferred alphanumeric character set, arrangement A 

Preferred alphanumeric character set, arrangement H 

PL/I alphanumeric character set 

PL/I preferred alphanumeric character set for scientific applications 

PL/1 preferred alphanumeric character set for commercial applications 

Preferred character set for commercial applications of FORTRAN and COBOL 

Preferred character set for text printing 

Character set for text printing, 120 characters 

High-speed alphanumeric character set for 1403, Model 2 

High-speed preferred alphanumeric character set for 1403, Model Nl 


Note: Where three values exist (for the 1403, 321 1, and 3203 Model 5 printers), code any one of them. JES selects 
the set corresponding to the device on which the data set is printed. 

Not all of these character sets may be available at your installation. Also, an installation can design character sets 
to meet special needs and assign a unique code to them. Follow installation procedures for using character sets. 



Figure 17-2. Special Character Sets for the 1403, 3203 Model 5, and 3211 Printers 



For printing on a printer with the UCS feature, a UCS parameter on the sysout DD statement 
overrides the OUTPUT JCL UCS parameter. For printing on a 3800, a CHARS parameter on 
the sysout DD statement or the OUTPUT JCL statement overrides all UCS parameters. 

For a data set scheduled to the Print Services Facility (PSF), the PSF uses the following 
parameters, in override order, to select the font list: 

1. Font list in the hbrary member specified by an OUTPUT JCL PAGEDEF parameter. 

2. DD CHARS parameter. 

3. OUTPUT JCL CHARS parameter. 

4. DD UCS parameter. 

5. OUTPUT JCL UCS parameter. 

6. JES installation default for the device. 

7. Font list on the PAGEDEF parameter in the PSF cataloged procedure. 
See "PAGEDEF Parameter" on page 17-48 for more information. 
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Using Special Cliaracters Sets 



To use a special character set, SYSl.IMAGELIB must contain an image of the character set, 
and the chain or train for the character set must be available. IBM provides standard special 
character sets, and the installation may provide user-designed special character sets. 



Example of the UCS Parameter 



//PRTDS9 OUTPUT UCS-All 

In this example, JES uses standard EBCDIC character set arrangement A, with 48 characters, 
to print the sysout data set on a 321 1 printer. 
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WRITER Parameter 



Parameter Type: Keyword, optional 

Purpose: Use the WRITER parameter to name an external writer to process the sysout data 
set rather than JES. An external writer is an IBM- or installation-written program. 

References: For information about external writers, see SPL: System Modifications. 

Syntax: 



WRITER=name 



Subparameter Definition 



Defaults 



Overrides 



name 

Identifies an external writer, name is 1 through 8 alphanumeric characters. 

Do not code INTRDR or STDWTR as the writer name. These names are reserved for 
JES. 



If you do not code the WRITER parameter, the installation's job entry subsystem processes the 
sysout data set. 



The writer-name subparameter of the SYSOUT parameter on the sysout DD statement 
overrides the OUTPUT JCL WRITER parameter. 



Starting an External Writer 



When a statement supplying processing options for a sysout data set specifies an external writer, 
the writer must be started before it can print or punch the data set. The writer is started by a 
system command from the operator or in the input stream. If the writer is not started before 
the job produces the sysout data set, the data set is retained until the writer is started. 
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Example of the WRITER Parameter 



//MYOUT JOB ACCT928,MAEBIRD,MSGCLASS=B 

// START XWTR 

//MYDS OUTPUT WRITER=XWTR 

//STEPl EXEC PGM=REPORT 

//RPTl DD SYSOUT=A,OUTPUT=MYDS 

In a JES2 system, the second statement is a JCL command statement to start the IBM-supplied 
external writer. This writer is invoked by the XWTR cataloged procedure in SYSl.PROCLIB. 
The sysout DD statement RPTl explicitly references OUTPUT JCL statement MYDS, which 
specifies that the external writer, XWTR, is to process the sysout data set. 

//** START XWTR 

//MYOUT JOB ACCT928,MAEBIRD,MSGCLASS=B 

//MYDS OUTPUT WRITER=XWTR 

//STEPl EXEC PGM=REPORT 

//RPTl DD SYSOUT=A,OUTPUT=MYDS 



This example is for a JES3 system. 
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Chapter 18. PEND Statement 



Purpose: Use the PEND statement to mark the end of an in-stream procedure. 
Syntax: 



//[name] PEND [comments] 



The PEND statement consists of the characters // in columns I and 2 and three fields: 
name, operation (PEND), and comments. 

Do not continue a PEND statement. 



Name Field 

A name is optional on the PEND statement. If used, code it as follows: 

• Each name must be unique within the job. 

• The name must begin in column 3. 

• The name is 1 through 8 alphanumeric or national characters. 

• The first character must be alphabetic or national. 

• The name must be followed by at least one blank. 

If a name is not coded, column 3 must be blank. 

Operation Field 

The operation field consists of the characters PEND and must be preceded and followed by at 
least one blank. It can begin in any column. 

Comments Field 

The comments field follows PEND after at least one intervening blank. 
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PEND 



Location in the JCL 



A PEND statement follows the statements of an in-stream procedure. Never place a PEND 
statement in a cataloged procedure. 

Examples of the PEND Statement 



//PROCENDl PEND THIS STATEMENT IS REQUIRED FOR IN-STREAM PROCEDURES 

This PEND statement contains a comment. 

// PEND 

This PEND statement contains only // and the operation field with the necessary blanks. 
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Chapter 19. PROC Statement 



Purpose: The PROC statement must mark the beginning of an in-stream procedure and, 
optionally, may mark the beginning of a cataloged procedure. For either procedure, the PROC 
statement can assign default values to symbolic parameters, if coded, in the procedure. 



Syntax: 



For a cataloged procedure: 

//[name] PROC [parameter] [comments] 
//[name] PROC 

For an in-stream procedure: 

//name PROC [parameter] [comments] 
//name PROC 



A PROC statement consists of the characters // in columns 1 and 2 and four fields: name, 
operation (PROC), parameter, and comments. 

IVIultiple Parameters: When more than one parameter is coded, separate parameters by 
commas. For example, //PI PROC PARISH =OLD,PARIV[2 = 222001. 

Special Characters: When a parameter value contains special characters, enclose the value in 
apostrophes. The enclosing apostrophes are not considered part of the value. For example, 
//P2 PROC PAR]V[3 = 3400-6'. 

Code each apostrophe that is part of a value as two consecutive apostrophes. For example, 
//P3 PROC PARM4 = '0"DAY'. 

Continuation onto Another Statement: End each statement with a comma after a complete 
parameter. For example: 

//P4 PROC PARM5=0LD , PARM6= ' SYS 1 . LINKLIB ( P40 ) ' , 
// PARM7=SYSDA , PARM8= ' ( CYL ,(10,1))' 
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PROC 

Name Field 



A name is required on a PROC statement in an in-stream procedure and is optional on a 
PROC statement in a cataloged procedure. Code it as follows: 

• Each name must be unique within the job. 

• The name must begin in column 3. 

• The name is I through 8 alphanumeric or national characters. 
9 The first character must be alphabetic or national. 

• The name must be followed by at least one blank. 

If a name is not coded, column 3 must be blank. 



Operation Field 



The operation field consists of the characters PROC and must be preceded and followed by at 
least one blank. It can begin in any column. 



Parameter Field 



The parameters on a PROC statement assign default values to symboUc parameters on 
procedure statements. An in-stream PROC statement requires parameters only if the procedure 
contains symbolic parameters. See "Symbolic Parameters" on page 5-8 for details on symbolic 
parameters and on how to assign values to them. 

If coded, the parameter field must be preceded and followed by at least one blank. 



Comments Field 



Overrides 



The comments field follows the parameter field, if coded, or PROC, if not, after at least one 
intervening blank. 



To override a default parameter value on a FKUC statement, code the same parameter on the 
EXEC statement that calls the procedure. 



Location in the JCL 



A PROC statement must begin all in-stream procedures and may begin a cataloged procedure. 
An in-stream procedure must appear in the same job before the EXEC statement that calls it. 
A cataloged procedure appears in a procedure library, usually SYSl.PROCLIB. 
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PROC 

Examples of the PROC Statement 



//DEF PROC STATUS=OLD,LIBRARY=SYSLIB,NUMBER=777777 

//NOTIFY EXEC PGM=ACCUM 

//DDl DD DSNAME=MGMT,DISP=(&STATUS,KEEP) ,UNIT=3400-6, 

// VOLUME=SER=888888 

//DD2 DD DSNAME=&LIBRARY,DISP=(OLD,KEEP) ,UNIT=3350, 

// VOLUME=SER=&NUMBER 

Three symbolic parameters are defined in this cataloged procedure: &STATUS, &LIBRARY, 
and &NUMBER. Values are assigned to the symbolic parameters on the PROC statement. 
These values are used when the procedure is called and values are not assigned to the symbolic 
parameters on the calling EXEC statement. 

//CARDS PROC 

This PROC statement can be used to mark the beginning of an in-stream procedure named 
CARDS. 
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JES2 



Chapter 20. JES2 Control Statements 



Code JES2 control statements with JCL statements to control the input and output processing 
of jobs. The rules for coding in Chapter 3, "Format of Statements" and Chapter 4, "Syntax of 
Parameters" apply to the JES2 control statements. 



Location in the JCL 



Place JES2 control statements, except the command and /*PRIORITY statements, after the 
JOB statement and its continuations. JES2 ignores JES2 control statements, except the 
command and /*PRIORITY statements, that appear before the JOB statement or between 
continued JOB statements. 

Do not include JES2 control statements in a cataloged or in-stream procedure. JES2 ignores 
JES2 control statements in a procedure. 



Internal Reader 



Use the following control statements when submitting jobs to the internal reader. The internal 
reader is described in SPL: JES2 Initialization and Tuning and SPL: System Modifications. 

/♦DEL 
/*EOF 
/♦PURGE 

/♦SCAN 



JES2: Command 



JES2 Command Statement 

Purpose: Use the command statement to enter a JES2 operator command through the input 
stream, the internal reader, or the system console. 

JES2 usually executes an in-stream command as soon as it is read. Therefore, the command 
will not be synchronized with the execution of any job or step in the input stream. To 
synchronize a command with the job processing, tell the operator the commands you want and 
when they should be issued, and let the operator enter them from the console. 

Examples in this book illustrate the format for commands entered through the input stream. 
Commands entered through an operator console should not have /* in columns 1 and 2. 

References: For more information on the command statement and the JES2 verbs and 
operands, see JES2 Commands. 



Syntax: 



/*$ command- verb, operandi , operand] . . . 



[N] 



The JES2 command statement consists of: 

• The characters /* in columns 1 and 2. 

w $ Ox a character chosen by the installation in column 3. 

% The command verb beginning in column 4. 

• A comma. 

• Operands up through column 71. 

• N in column 72 if JES2 is not to write the command on the operator console. 
© Blanks in columns 73 through 80. JES2 ignores these columns. 

Do not continue command statements from one statement to the next, instead code as many 
command statements as you need. 



Parameter DefiRition 



command-verb 

Specifies the operator command that JES2 is to perform. You can enter the following 
JES2 commands in the input stream. 

$A $E $1 $0 $T 

$B $F $L $P $TRACE 

$C $G $M $R $V 

$D $H $N $S $Z 

operand 

Specifies options for the command. 

N in column 72 

Indicates that JES2 is not to repeat the command on the operator console. 
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Location in the JCL 



Place command statements before jobs being entered through the input stream. JES2 ignores 
any command statements within a job. 

If a job contains a JES2 /*XMIT statement, place the command statement: 

• Before the /*XMIT statement if you want JES2 to process and display the command at the 
input node only. 

• After the /*XMIT statement if you want JES2 to process and display the command at the 
execution node only. 

Examples of the Command Statement 



/*$SI3-5 

This command statement starts initiators three through five. The command is $S and the 
operand is 13-5. JES2 executes the command immediately and repeats the command on the 
operator console. 

/*$TRDR1,H=Y 

In response to this command, JES2 places all jobs being read by reader 1 in a hold status. If a 
job contains a JES2 /* ROUTE XEQ or /*XEQ statement that specifies an execution node 
different from the input node, JES2 holds the job at the execution node, not the input node. 
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/*JOBPARM Statement 



Purpose: Use the /*JOBPARM statement to specify job-related parameters for JES2. 
Syntax: 



/*JOBPARM parameter [ , parameter] . . . 
The parameters are: 

Iburst1=|y 
1b I In 



BYTES 
M 

CARDS 
C 



=nnnnnn 



=nnnnnnn 



COPIES j=nnn 

In I 

FORMS 1 = I xxxxxxxx 
F I [STD 

fLINECTl=nnn 

Ik I 

IT TVfPC' I _«. — — — 



NOLOG 
J 



I PAGES 



=nnnnn 



PROCLIB 
P 

RESTART 
E 



=ddname 



ROOM 
R 



=xxxx 



SYSAFF = 
S 1 



' 



(*[,-INDl) 
ANY 

(ANY[,IND] ) 
cccc 
(cccc[ ,IND] ) 
(cccc[ ,cccc] 



) 



J (cccc[ ,cccc] . . . ) [ ,IND] ) 



TIME 
T 



=nnnn 
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The /* JOBPARM statement consists of the characters /* in columns 1 and 2, JOBPARM in 
columns 3 through 9, a blank in column 10, and parameters in columns 11 through 71. JES2 
ignores columns 72 through 80. 

Do not continue a /*JOBPARM statement. Instead, code as many /* JOBPARM statements 
as necessary in an input stream. 

Code any number of the above parameters on a single /*JOBPARM statement. 



Parameter Definition 



BURST =Y 
BURST = N 

Specifies the default burst characteristic of all sysout data sets that JES2 produces for this 
job. BURST is vaUd only when the data set is directed to a 3800 Printing Subsystem 
equipped with a burster-trimmer-stacker. 

Y 

Requests that the 3800 output is to be burst into separate sheets. 

N 

Requests that the 3800 output is to be in a continuous fanfold. 

BYTES = nnnnnn 

Specifies the maximum output, in thousands of bytes, the system is to produce from this 
job. The nnnnnn is 1 through 6 decimal numbers from through 999999, 

When the job's output exceeds the BYTES value, JES2 sends a message to the operator. 
The job may be terminated, depending on the installation options specified at 
initialization. 

CARDS = nnnnnnn 

Specifies the maximum number of output cards to be punched for this job's sysout data 
sets. The nnnnnnn is 1 through 7 decimal numbers from through 9999999. 

COPIES = niin 

Specifies how many copies of the spool lines or bytes for this job's sysout data sets are to 
be printed or punched. The nnn is 1 through 3 decimal numbers from 1 through 255. An 
installation can reduce the upper limit of this value during JES2 initiahzation. 

The COPIES parameter is ignored and only one copy is produced if any of the following 
is true: 

• FREE = CLOSE is coded on the DD statement for the output data set. 

• HOLD = YES is coded on any sysout DD statement in the job. 

• The output class of the sysout data set is a held class, and the message class is also a 
held class. The message class is specified in the JOB statement MSGCLASS 
parameter. 
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FORMS = xxxxxxxx 
FORMS = STD 

Specifies the print and/or punch forms JES2 is to use for sysout data sets for which 
FORMS is not specified on the DD statement or on a JES2 /*OUTPUT statement. 



xxxxxxxx 

Identifies the print or punch forms. The xxxxxxxx is 1 through 8 alphanumeric or 
national characters. 

STD 

Indicates that JES2 is to use the default specified at JES2 initialization. 

LINECT = nnn 

Specifies the maximum number of lines that JES2 is to print on each output page for this 
job's sysout data sets. The nnn is 1 through 3 numbers from through 255. 

If you code LINECT = 0, JES2 does not eject to a new page when the number of output 
lines exceeds the page limit that the installation specified during JES2 initialization. 

The LINECT parameter on the /*OUTPUT statement overrides LINECT on the 
/*JOBPARM statement and the linect value in the accounting information parameter of 
the JOB statement. 

LINES = nnnn 

Specifies the maximum output, in thousands of lines, that JES2 is to place in the spool 
data sets for this job's sysout data sets. The nnnn is 1 through 4 decimal numbers from 
through 9999. When nnnn lines are reached, JES2 gives control to a user exit routine. 

NOLOG 

Requests that JES2 not print the job's hard-copy log. The job's hard-copy log contains 
the JES2 and operator messages about the job's processing: allocation of devices and 
volumes, execution and termination of job steps and the job, and disposition of data sets. 

PAGES = nniinn 

Specifies the maximum number of output pages to be printed for this job's sysout data 
sets. The nnnnn is 1 through 5 decimal numbers from through 99999. 

PROCLIB = ddname 

Requests a JES2 procedure library by its ddname in the system procedure hbrary, 
SYSl.PROCLIB. These JES2 procedure library ddnames are in the format PROCnn, 
where nn is 1 or 2 decimal numbers from 1 through 99. The system retrieves called 
cataloged procedures from the requested JES2 procedure library. If this parameter is 
omitted or appears but the library cannot be found, the library can be specified by 
class-related initialization parameters; otherwise, the default, PROCOO, is used. 

RESTART = Y 
RESTART = N 

Requests one of the following, if this job is executing before a re-IPL and JES2 warm 
start, and the job cannot restart from a step or checkpoint. 

Y 

Requests that JES2 queue the job for re-execution from the beginning of the job. 
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N 

Requests that JES2 take no special action. 

Note: If you do not specify RESTART, JES2 assumes N. However, the installation may 
override this default in JES2 initialization parameters. 

ROOM = xxxx 

Indicates the programmer's room number. The xxxx is 1 through 4 alphanumeric 
characters. JES2 places the room number on the job's separators so that the installation 
can deliver the job's sysout data sets to the programmer. 

SYSAFF = * 
SYSAFF = (*l,INDl) 

SYSAFF = ANY 
SYSAFF = (ANY[,IND1) 
SYSAFF = cccc 
SYSAFF = (ccccI,INDl) 
SYSAFF = (ccccl,ccccl...) 
SYSAFF = ((cccc[,ccccl...)l,INDl) 

Indicates the systems that are eligible to process the job. The parameter indicates from 1 

through 7 system affinities. 

Note: The SYSAFF parameter must not be specified in TSO-submitted jobs. 

* 

Indicates the system that read the job. 

ANY 

Indicates any system in the JES2 multi-access spool configuration. 

cccc 

Indicates a specific system, cccc must be the 4-alphanumeric-character system id of 
one of the systems in the JES2 multi-access spool configuration. To specify more 
than one system, separate the system ids with commas and enclose the system id list 
in parentheses; for example, SYSAFF = (cccc,cccc,cccc). Repeat cccc up to the 
number of processors in the configuration. 

IND 

After any of the other SYSAFF specifications, indicates that JES2 is to use system 
scheduling in independent mode. When IND is coded, the subparameters must be 
enclosed in parentheses. 

TIME = nnnn 

Estimates the job execution time, in minutes of real time. The nnnn is 1 through 4 
decimal numbers from through 9999. If you omit a TIME parameter and a time 
subparameter in the JOB statement accounting information parameter, JES2 uses an 
installation default specified at initialization. If job execution exceeds the time, JES2 
sends a message to the operator. 
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Overrides 

• The /*JOBPARM statement parameters override the installation defaults specified at JES2 
initialization. 

• An OUTPUT JCL statement can override parameters on a /*JOBPARM statement. 

• A JES2 /*OUTPUT statement can override parameters on a /*JOBPARM statement. 

• Any /*JOBPARM statement parameter value overrides the equivalent parameter value 
from the JES2 accounting information on the JOB statement or from any preceding 
/*JOBPARM statement in this job. 

Location in tlie JCL 

Place the /*JOBPARM statement after the JOB statement. 

Execution Node 

JES2 normally processes /*JOBPARM statements at the node of execution. 

When you place a /*JOBPARM statement before a /* ROUTE XEQ or /*XEQ statement, JES2 
at the input node checks the /*JOBPARM statement for syntax and parameter vaHdity. After 
processing the /* ROUTE XEQ or /*XEQ statement, JES2 then passes the /*JOBPARM 
statement to the execution node, where syntax and parameter validity are again checked. 

When you place a /*JOBPARM statement after a /* ROUTE XEQ or /*XEQ statement, JES2 
passes the /*JOBPARM to the execution node and performs all syntax and parameter validity 
processing at the execution node only. 

COPIES Parameter in Remote Processing: In remote processing, the COPIES parameter on 
the /*JOBPARM statement determines the number of output copies only when the execution 
node is a JES2 node. The /*JOBPARM COPIES parameter is not supported by RSCS, 
DOS/VSE POWER, or JES3. 
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Example of the /* JOBPARM Statement 



/*JOBPARM LINES=60,ROOM=4222,TIME=50,PROCLIB=PROC03,COPIES=5 
/* JOBPARM L=60,R=4222,T=50,P=PROC03,N=5 

The two statements specify the same parameters and values. The parameter specifications mean 
the following: 

LINES = 60 or L = 60 

The job's estimated output will be 60,000 lines. 

ROOM = 4222 or R = 4222 

The programmer's room is 4222. JES2 places this information in the separators for both 
printed and punched data sets. 

TIME = 50 or T = 50 

The job's estimated execution time is 50 minutes. 

PROCLIB = PROC03 or P = PROC03 

The procedure library that JES2 is to use to convert the JCL for this job is PROC03. 

COPIES = 5 or N = 5 

The estimated 60,000 Mnes of output will be printed five times. 
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/*MESSAGE Statement 



Purpose: Use tlie /*MESSAGE statement to send messages to the operator console when JES2 
reads in the job. 

Syntax: 



/*MESSAGE message 



The /*MESSAGE statement consists of the characters /* in columns 1 and 2, MESSAGE in 
columns 3 through 9, a blank in column 10, and the message starting in any column from 11 
through 71. JES2 ignores columns 72 through 80. 



Relationship to the /*ROUTE XEQ Statement 

If the /*MESSAGE statement is in a job that also contains a JES2 /*ROUTE XEQ statement: 

• Placing the /*MESSAGE statement before the /*ROUTE XEQ statement directs JES2 to 
send the message to the operators at the input node and the execution node. 

• Placing the /*MESSAGE statement after the /*ROUTE XEQ statement directs JES2 to 
send the message only to the operator at the execution node. 

Location in the JCL 

If the /*MESSAGE statement is after the JOB statement, JES2 appends the job number to the 
beginning of the message. 

If the /*MESSAGE statement is not within a job, JES2 appends the input device name to the 
beginning of the message. 

Example of the /*MESSAGE Statement 

/*MESSAGE CALL DEPT 58 WHEN PAYROLL JOB IS FINISHED— EX . 1946 

JES2 sends this message lo the operator console when the job is read in. 
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/*NETACCT Statement 



Purpose: Use the /*NETACCT statement to specify an account number that is available to all 
the nodes in a network. JES2 uses the account number as is or translates it to local account 
numbers. 

Syntax: 



/*NETACCT network-account-number 



The /*NETACCT statement consists of the characters /* in columns 1 and 2, NETACCT in 
columns 3 through 9, a blank in column 10, and the network account number starting in any 
column from 11 through 71. JES2 ignores columns 72 through 80. 



Parameter Definition 



Defaults 



network-account-number 

Specifies the job's accounting number. The network-account-number is 1 through 
alphanumeric characters. 



If no /*NETACCT statement is specified, JES2 uses the local account number to search a table 
for the network account number. 



Overrides 

If you supply both a /*NETACCT and a local account number, JES2 uses the local account 
number on the input node. 

Location in the JCL 

Place the /*NETACCT statement after the JOB statement. 

If a job contains more than one /*NETACCT statement, JES2 uses the network account 
number from the last statement. 

JES2 ignores the /*NETACCT statement on any node other than the input node. 
Example of the /*NETACCT Statement 

/*NETACCT NETNUMIO 

JES2 transmits the network account number, NETNUMIO, with the job to the destination 

K node. 

^ . 
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/*NOTIFY Statement 



Fmpose: Use the /*NOTIFY statement to direct a job's notification messages to a user. 

Note: The /*NOTIFY statement does not affect where the job is executed or where output is 
printed or punched. 



Svntax; 



/*NOTIFY 



' nodename . user id 
nodename : user id 
nodename/userid > 
nodename (user id) 
userid 



The /*NOTIFY statement consists of the characters /* in columns 1 and 2, NOTIFY in 
columns 3 through 8, a blank in column 10, and a parameter starting in any column from 11 
through 71, JES2 ignores columns 72 through 80. 

Do not code a comma, a right parenthesis, or a blank character in the nodename or userid. 



Parameter Definition 



Overrides 



nodename.userid 
nodenameruiserid 
nodename/userid 
nodename(userid) 

Identifies a node and a TSO or VM userid at that node. The nodename is a symbolic 
name defined by the installation during initialization; nodename is 1 through 8 
alphanumeric or national characters. The userid must be defined at the node; userid for 
TSO is 1 through 7 alphanumeric or national characters and for VM is 1 through 8 
alphanumeric or national characters. 

When you specify a nodename and userid, JES2 sets the origin node field in the job's 
network job header to the specified node, even though the job origin node may be 
different. 



userid 



Identifies a TSO or VM user. The userid for TSO is 1 through 7 alphanumeric or 
national characters and for VM is 1 through 8 alphanumeric or national characters. 
When you specify only a userid, JES2 assumes that the userid is at the origin node. 



The JES2 /*NOTIFY statement overrides the NOTIFY parameter on the JOB statement. 
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Relationship to Other Control Statements 



If you submit a TSO job with a JOB statement NOTIFY parameter or the job includes a JES2 
/♦NOTIFY statement, do not specify IND in a JES2 /*JOBPARM SYSAFF parameter; the 
IND subparameter would change the mode of the job. This change would be invalid because 
the mode of the job must match the mode of the system at which the job is submitted. 

Location in the JCL 

The /*NOTIFY statement directs the notification messages of the job in which it appears; 
place the /♦NOTIFY statement after the JOB statement and before the first EXEC statement. 

Examples of the NOTIFY Statement 



/♦NOTIFY VMNODE . VMUSER 

JES2 sends notification messages to user VMtTSER on node VMNODE. 

/♦NOTIFY TSOUSER 

JES2 sends notification messages to user TSOUSER on the job's origin node. 
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/*OUTPUT Statement 



Purpose: Use the /*OUTPUT statement to specify characteristics and options for one or more 
sysout data sets. This statement supplies processing options in addition to and in place of the 
options specified on the sysout DD statement. 

Note: You should use the OUTPUT JCL statement instead of the JES2 /*PUTPUT statement 
because of the OUTPUT JCL statement's enhanced output processing capabilities. 



Syntax: 



/*OUTPUT code parameter [ , parameter] . . . 


The parameters are: 




BURST I = 


= Y 






B 


N 




CHARS 1 = 


= xxxx 


X 


(xxxx[ ,xxxx] . . . ) 


CKPTLNf 
E 


J =nnnnn 




CKPTPGS =nnnnn 
P 


(compact =nn 


iz 1 




COPIES 


= 


nnn 






N 




( nnn [ , ( group-value [ , group-value ]...)]) 






COPYG = 


= group-value 






G 


( group-value [ , group-value] . . . ) 






DEST = 


destination 


destination is: 




D ( 


(destination [ , destination] . . . ) 


/ \ 


' : ' 1 


LOCAL 






FCB 


=xxxx 


name 






C 




Nnnnn 




. . . . ! 


Nnn Rmmmm 






FLASH = 


= overlay-name 




NnnnRmmm 









( over lay-name [ , count ] ) 




NnnnnRmm 






NONE 


I 


nodename.userid \| 


1 

FLASHC =count 


nodename : user id 


^ 


nodename/userid 




nodename (userid) 




' 


Rnnnn 




(forms = 


= xxxx 




RMnnnn 




F 


STD 




RMTnnnn 




\ 


> Unnnn , 
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INDEX 
I 



=nn 



LINDEX =nn 
L 



LINECT 
K 

MODIFY 
Y 

MODTRC 
M 



=nnn 



module-name 
(module-name [ ,trc] ) 



=trc 



UCS =xxxx 

T 



The /*OUTPUT statement consists of the characters /* in columns 1 and 2, OUTPUT in 
columns 3 through 8, a blank in column 9, a code beginning in column 10, followed by a 
blank and the keyword parameters. JES2 ignores columns 72 through 80. 

An * in column 10 indicates that this /*OUTPUT statement is a continuation of the previous 
/♦OUTPUT statement: JES2 treats it as a continuation, even through the previous 
/♦OUTPUT statement does not immediately precede the continuation. 

Do not specify * in column 10 on the first /*OUTPUT statement in a job. 



Parameter Definition 



code 



Identifies the /*OUTPUT statement. The code is 1 through 4 alphanumeric characters. 
To refer to a /*OUTPUT statement, the DD statement SYSOUT parameter must specify 
this code in its code-name subparameter. The referenced /*OUTPUT statement specifies 
processing options for the sysout data set defined in the referencing DD statement. 

A code of * indicates that this /*OUTPUT statement is a continuation of the previous 
/♦OUTPUT statement. 

Note: If you specify the code-name subparameter on a DD statement SYSOUT 
parameter in a job or job step that contains an OUTPUT JCL statement, JES2 uses the 
code-name as the name of an output form instead of as a reference to a /*OUTPUT 
statement. 

If more than one /♦OUTPUT statement has the same code starting in column 10, JES2 
uses the parameters from only the first /♦OUTPUT statement. 
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BURST = Y 
BURST = N 

Indicates the default burst characteristic of all sysout data sets that JES2 produces for this 
job. BURST is valid only v/hen the data set is directed to a 3800 Printing Subsystem 
equipped with a burster-trimmer-stacker. 



Y 



N 



Requests that the 3800 output is to be burst into separate sheets. 



Requests that the 3800 output is to be in a continuous fanfold. 



CHARS = xxxx 

dxAKS ''^ (xxxx[,xxxxj«i.j 

Names a character-arrangement table for all output that JES2 prints on a 3800 Printing 
Subsystem in this job. The xxxx is 1 through 4 alphanumeric or national characters. 
Code one to four names. 

CKPTLNS = nnniiti 

Specifies the maximum number of lines or cards contained in a logical page. The nnnnn is 
1 through 5 decimal numbers from through 32767 for printers and 1 through 32767 for 
punches. The default is specified in the JES2 initialization parameter for the device. 

CKFTPGS = nnnnn 

Specifies the number of logical pages to be printed before the next checkpoint is taken. 
The nnnnn is 1 through 5 decimal numbers from 1 through 32767. The default is 
specified in the JES2 initialization parameter for the device. 

COMPACT = nE 

Specifies a compaction table for JES2 to use when sending this sysout data set, which 
must be a systems network architecture (SNA) data set, to a SNA remote terminal. 

Note: The COMPACT parameter has no effect on compaction for NJE sessions; it 
applies only to SNA RJE sessions. 

COPIES = nnn 

COPIES = (nnn(,(group-value[,group-vaIuel...)l) 

Specifies how many copies of the sysout data set arc to be printed in page sequence order, 

or from a 3800 Printing Subsystem, grouped by page. 

If you route a job that has a COPIES parameter, the parameter will be used only if the 
receiving node is a JES2 node. 



nnn 



Specifies how many copies of the sysout data set are to be printed; each copy will 
be in page sequence order. The nnn is 1 through 3 decimal numbers from 1 through 
255, subject to an installation-specified limit. For a data set printed on a 3800, 
JES2 ignores nnn if any group values are specified. 

If you omit or incorrectly code the nnn parameter of COPIES, it defaults to 1 and a 
warning message is issued. 
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group-value 

Specifies how many copies of each page are to be printed before the next page is 
printed. Each group-value is 1 through 3 decimal numbers from 1 through 255. 
You can code a maximum of eight group- values. Their sum must not exceed 255 or 
the installation-specified limit. The total copies of each page equals the sum of the 
group-values. 

Note: 

• This subparameter is valid only for 3800 output. 

• For 3800 output, this subparameter overrides the nnn subparameter. 

The follov^ing are not vaUd: 

• A null group-value, for example, COPIES = (5(,)) or COPIES = (5,) 

• A zero group-value, for example, COPIES = (5,(1,0,4)) 

• A null within a Ust of group-values, for example, COPIES = (5,(1 „4)) 

COPYG = group-value 

COPYG = (group-value[,group-valueI...) 

Specifies how many copies of each page are to be printed before the next page is printed. 
Each group- value is 1 through 3 decimal numbers from 1 through 255. You can code a 
maximum of eight group-values. Their sum must not exceed 255. The total copies of 
each page equals the sum of the group-values. 

Note: This parameter is valid only for 3800 output. If you code COPYG and JES2 
prints the data set on an impact printer, JES2 ignores COPYG. 

DEST = destination 

DEST = (destination[,destination]...) 

Specifies one to four different destinations for the sysout data set. The destination 
subparameters follow: 

LOCAL 

Indicates any local device. 

name 

Identifies a local or remote device by a symbolic name defined by the installation 
during JES2 initialization. The name is 1 through 8 alphanumeric or national 
characters. 

Nnnnn 

Identifies a node, nnnn is 1 through 4 decimal numbers from 1 through 1000. For 
example, NO 103. 
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NnnRmmmm 
NnnnRmmni 



Identifies a node and a remote work station connected to the node. The node 
number, indicated in the format by n, is 1 through 4 decimal numbers from 1 
through 1000. The remote work station number, indicated in the format by m, is 1 
through 4 decimal numbers from 1 through 4000. Do not code leading zeros in n or 
m. The maximum number of digits for n and m combined cannot exceed six. 

Note: RO is equivalent to LOCAL specified at node Nn. 

nodename.userid 
nodename:u$erid 
nodename/userid 
nodenaine(userid) 

Identifies a destination node and a TSO or VM userid at that node. Use this 
parameter to route a sysout data set between JES2 nodes and non-JES2 nodes. The 
nodename is a symbolic name defined by the installation during initiaUzation; 
nodename is 1 through 8 alphanumeric or national characters. The userid must be 
defined at the node; userid for TSO is 1 through 7 alphanumeric or national 
characters and for VM is 1 through 8 alphanumeric or national characters. 

Use the form nodename.userid to specify up to four destinations using continuation 
statements. The continuation statement must contain the characters /* in columns 1 
and 2, OUTPUT in columns 3 through 8, a blank in column 9, an * in or following 
column 10, followed by one or more blanks, and the characters DEST== with the 
specified destinations. For example: 

/♦OUTPUT ABCD DEST= (POK.USER27 ,NYC . USER31) 
/*OUTPUT * DEST=( BOCA. USER58, STL. USER22) 

Use the form nodename:userid to submit a job to an MVS system from a VM userid 
and to receive the output in the VM user's virtual reader. 

Use the form nodename.userid to send the output to the local VM printer. 

Note: If a data set is queued for transmission and an operator changes its 
destination, the userid portion of the original routing is lost. 

Rnnnn 

RMnnnn 

RMTnnnn 

Identifies a remote terminal, nnnn is 1 through 4 decimal numbers from 1 through 
4000. 

Note: RO is equivalent to LOCAL. 

Unnnn 

Identifies a local terminal with special routing, nnnn is 1 through 4 decimal 
numbers from 1 through 4000. 
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FCB = xxxx 

Identifies the forms control buffer (FCB) image JES2 is to use to guide printing of the 
sysout data set. The xxxx is 1 through 4 alphanumeric or national characters and is the 
last characters of a SYSl.IMAGELIB member name: 

• FCB2xxxx member, for a 3211 Printer, a 3203 Printer Model 5, or a printer 
supported by systems network architecture (SNA). 

• FCB3xxxx member, for a 3800 Printing Subsystem. 

• FCB4xxxx member, for a 4248 Printer. 

IBM provides two standard FCB images. Code STDl or STD2 only to request them. 

• STDl, which specifies 6 Unes per inch on an 8.5-inch-long form. 

• STD2, which specifies 6 Unes per inch on an 1 1 -inch-long form. 

If the printer on which JES2 is to print the data set does not have the forms control 
buffer feature, JES2 sends the operator a message to mount the proper carriage control 
tape. 

FLASH = overlay-name 
FLASH = (overlay-name[,couiit]) 
FLASH = NONE 

Identifies the forms overlay to be used in printing the sysout data set on a 3800 Printing 
Subsystem and, optionally, specifies the number of copies on which the forms overlay is 
to be printed. 

overlay-name 

Identifies the forms overlay frame that the operator is to insert into the printer 
before printing begins. The name is I through 4 alphanumeric or national 
characters. 

Do not omit the overlay-name. The count subparameter is optional. If you omit it, 
you can omit the parentheses. However, if you omit it, you must not code it as a 
null; for example, FLASH = (ABCD,) is invalid. 

Before printing starts, JES2 does not verify that the operator inserted the correct 
forms overlay frame for flashing. 

count 

Specifies the number, 1 through 255, of copies that JES2 is to flash with the overlay, 
beginning with the first copy printed. 

JES2 determines the maximum number of copies to flash with the forms overlay by 
the value of nnn or the group-value total on the COPIES parameter. If the FLASH 
count value is greater than the value from the COPIES parameter, JES2 prints with 
the forms overlay the lower value. 

The count subparameter of the FLASH parameter overrides the count value of the 
FLASHC parameter. 
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NONE 

Suppresses flashing for this data set. 

Defaults: If you omit this parameter and did not specify FLASH on the DD statement or 
FLASHC on the /*OUTPUT statement, JES2 uses the default specified at JES2 
initiahzation. 

If you specify an overlay-name without specifying a count, JES2 flashes all copies. That 
is, the default for count is 255. If you specify G for count, JES2 also flashes all copies. 

FLASHC = count 

Specifies the number, through 255, of copies that JES2 is to flash with the overlay, 
beginning with the first copy printed. 

Note: For the 3800 printer, if you specify FLASH and omit FLASHC, JES2 flashes all 
copies. 

The count subparameter of the FLASH parameter overrides the count value of the 
FLASHC parameter. 

FORMS = xxxx 
FORMS = STD 

Identifies the forms on which JES2 is to print or punch the sysout data set. 

Identifies the print or punch forms, form-name is 1 through 4 alphanumeric or 
national characters. 

STD 

Indicates that JES2 is to use the default specified at JES2 initialization. 

INDEX = nn 

Sets the left margin for output on a 3211 Printer with the indexing feature. The width of 
the print line is reduced by the INDEX parameter value. The nn specifies how many 
print positions the left margin on the 321 1 output is to be indented, nn is a decimal 
number from 1 through 31. n= 1 indicates flush-left; n = 2 through n = 31 indent the 
print line by n-1 positions. 

JES2 ignores the INDEX parameter if the printer is not a 3211 with the indexing feature. 

INDEX and LINDEX are mutually exclusive; if you code both, JES2 uses the last one 
encountered. 

LINDEX = nn 

Sets the right margin for output on a 321 1 Printer with the indexing feature. The width 
of the print line is reduced by the LINDEX parameter value. The nn specifies how many 
print positions the right margin on 3211 output is to be moved in from the full page 
width, nn is a decimal number from 1 through 31. n = 1 indicates flush-right; n = 2 
through n = 31 move the right margin over by n-1 positions. 

JES2 ignores the LINDEX parameter on all printers except the 3211 with the indexing 
feature. 

INDEX and LINDEX are mutually exclusive; if you code both, JES2 uses the last one 
encountered. 
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LINECT = nnn 

Specifies the maximum number of lines JES2 is to print on each output page. The nnn is 
a number from through 255. 

Specify LINECT == to keep JES2 from starting a new page when the number of lines 
exceeds the JES2 initiahzation parameter. 

If you code LINECT on the /*OUTPUT statement, it overrides the LINECT value on the 
/♦JOBPARM statement and the Unect value in the accounting information parameter of 
the JOB statement. 

If the LINECT parameter is omitted from the /*OUTPUT statement, JES2 obtains the 
value from one of the following sources, in order: 

1. The LINECT parameter on the /*JOBPARM statement. 

2. The hnect field of the accounting information parameter on the JOB statement. 

3. The installation default specified at JES2 initialization. 

MODIFY = module-name 
MODIFY = (moduIe-narae(,trcl) 

Specifies a copy-modification module that tells JES2 how to print the sysout data set on a 
3800 Printing Subsystem. The module can specify legends, column headings, blanks, and 
where and on which copies the data is to be printed. The module is defined and stored in 
SYSl.IMAGELIB using the lEBIMAGE utility program. 

module-name 

Identifies a copy-modification module in SYSl.IMAGELIB. The module-name is 1 
through 4 alphanumeric or national characters. 



trc 



Do not omit the module-name. 

Identifies which table-name in the CHARS parameter is to be used. This table 
reference character is for the first table-name specified, 1 for the second, 2 for the 
third, or 3 for the fourth. 

If you do not specify trc, the default is 0. If the trc value is greater than the number 
of table-names in the CHARS parameter, JES2 uses the first table named in the 
CHARS parameter. 

The trc subparameter is optional. If you omit it, you can omit the parentheses. 
However, if you omit it, you must not code it as a null; for example, 
MODIFY == (TAB 1,) is invalid. If you omit the trc subparameter, JES2 uses the 
first table-name. 

The trc subparameter of the MODIFY parameter overrides the trc subparameter of 
the MODTRC parameter. 

MODTRC = trc 

Identifies which table-name in the CHARS parameter is to be used. This table reference 
character is for the first table-name specified, 1 for the second, 2 for the third, or 3 for 
the fourth. 
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If you do not specify trc, the default is 0. If the trc value is greater than the number of 
table-names in the CHARS parameter, JES2 uses the first table named in the CHARS 
parameter. 

The trc subparameter of the MODIFY parameter overrides the trc subparameter of the 
MODTRC parameter. 

UCS==xxxx 

Identifies the universal character set (UCS) image JES2 is to use in printing the sysout 
data set. The xxxx is 1 through 4 alphanumeric or national characters. See Figure 10-2 
on page 10-140 for IBM standard special character set codes. 



Overrides 



• /*OUTPUT statement parameters override all equivalent DD statement parameters. 

• If a /*OUTPUT statement contains duplicate parameters, the last parameter overrides all 
preceding duplicates, except for the DEST parameter. 

• Any parameter coded on subsequent /* OUTPUT statements overrides the same parameter 
on previous /*OUTPUT statements. 

• JES2 adds any parameter you code on subsequent /* OUTPUT statements that you did not 
code on previous /*OUTPUT statements to the previous /*OUTPUT statement. 

m If you code LINECT on the /*OUTPUT statement, it overrides the LINECT value on the 
/*JOBPARM statement and the Unect value in the accounting information parameter of the 
JOB statement. 

Relationship to Other Control Statements 

• JES2 processes /*OUTPUT statements placed after a /* ROUTE XEQ statement at the 
execution node only. 

• JES2 processes /*OUTPUT statements placed before a /*ROUTE XEQ statement at both 
the input node and the execution node. 

Location in the JCL 

Place the /*OUTPUT statement after the JOB statement and before the first EXEC statement. 

Example of the /*OUTPUT Statement 

/*OUTPUT ABCD C0PIES=6 ,COPYG= (1 , 2 , 3 ) ,DEST=RMT23 

This statement refers to all sysout data sets defined by a DD statement that specifies 
SYSOUT = (c„ABCD). Six copies of each page of output are printed. If the printer is a 3800, 
first one copy of each page is printed, then two copies of each page, and finally, three copies of 
each page. If the printer is not a 3800, COPYG is ignored and six copies of the entire data set 
are printed. The output is sent to remote terminal 23. 
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/*PRIORITY Statement 



Purpose: Use the /*PRIORITY statement to assign a selection priority for your job and all of 

its output, except the JES2 hard-copy log. Within a job class, a job with a higher priority is 
selected for execution sooner. 

Note: Depending on the JES2 initialization options in use at your installation, JES2 may 
ignore the /*PRIORITY statement. 

Syntax: 



/*PRIORITY p 



The /*PRIORITY statement consists of the characters /* in columns 1 and 2, PRIORITY in 
columns 3 through 10, a blank in column 10, and the priority starting in any column from 11 
through 71. JES2 ignores columns 72 through 80. 



Parameter Definition 
P 



Requests a priority. The p is 1 or 2 decimal numbers from through 15. The highest 
priority is 15. 

Follow your installation's rules in coding a priority. 



Overrides 



A priority specified on a /*PRIORITY statement overrides a priority specified in the PRTY 
parameter on a JOB statement. 

Relationship to Other Control Statements 

The system derives the priority from the following, in override order: 

1. JES2 /*PRIORITY statement. 

2. The PRTY parameter on the JOB statement. 

3. The accounting information on a /*JOBPARM statement. 

4. The accounting information on the JOB statement. 

5. An installation default specified at JES2 initiahzation. 
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Location in the JCL 

The /*PRIORITY statement must immediately precede the JOB statement. If not, or if p is not 
a number from through 15, JES2 ignores the /*PRIORITY statement and flushes the input 
stream until the next JOB statement or another /*PRIORITY statement. 

In a JES2 network, the /*PRIORITY statement must immediately follow the /*XMIT 
statement and precede a JOB statement. If the /*PRIORITY statement does not immediately 
follow an /*XM1T statement, JES2 ignores the /*PRIORITY statement at any node except the 
input node. 

Example of the PRIORITY Statement 



/*PRIORITY 7 

This statement assigns a job queue selection priority of 7. This value has meaning only in 
relation to other jobs in the system. 
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/*ROUTE Statement 



Purpose: Use the /*ROUTE statement to specify the destination of sysout data sets that are 
not routed by a DEST parameter or to identify the network node where the job is to execute. 



Syntax: 



/* ROUTE 



< 



/*ROUTE XEQ 



LOCAL 

name 

Nnnnn 

NnnRmmmm 

NnnnRmmm 

NnnnnRmm 

nodename . user id 
PRINT ^ nodename: user id 
PUNCH nodename/userid 

nodename (userid) 

Rnnnn 

RMnnnn 

RMTnnnn 
I Unnnn 

'Nnnnn 

nodename. vmquest id 

nodename : vmguest id 

nodename/vmguestid 

nodename ( vmguest id ) ^ 



> 



The /* ROUTE statement consists of the characters /* in columns 1 and 2; ROUTE in 
columns 3 through 7; at least one blank followed by PRINT, PUNCH, or XEQ; at least one 
blank followed by one of the destinations or nodes; and at least one blank before column 72. 
JES2 ignores columns 72 through 80. 

Code only one destination or node on each /* ROUTE statement. 



Parameter Definition 



PRINT 

Requests that JES2 route the job's sysout data sets that are printed. 

PUNCH 

Requests that JES2 route the job's sysout data sets that are punched. 



XEQ 



Requests that JES2 route the job to a network node for execution. 
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LOCAL 

Indicates any local device at the node at which the job is submitted. 

name 

Identifies a local or remote device by a symbolic name defined by the installation during 
JES2 initialization. The name is 1 through 8 alphanumeric or national characters. 

Nnnnn 

Identifies a node, nnnn is 1 through 4 decimal numbers from 1 through 1000. For 
example, NO 103. 

NimRmmiiiiii 
NnnnRmmni 
NnnnnRmm 

Identifies a node and a remote work station connected to the node. The node number, 
indicated in the format by n, is 1 through 4 decimal numbers from 1 through 1000. The 
remote work station number, indicated in the format by m, is 1 through 4 decimal 
numbers from 1 through 4000. Do not code leading zeros in n or m. The maximum 
number of digits for n and m combined cannot exceed six. 

Note: RO is equivalent to specifying LOCAL at node Nn. 

nodename.userid 
nodename:userid 
nodename/userid 
nodename(userid) 

Identifies a node and a VM userid at that node. The node is a symbolic name defined by 
the installation during initialization; nodename is 1 through 8 alphanumeric or national 
characters. The userid must be defined at the node; userid is 1 through 8 alphanumeric 
or national characters. 

A userid requires a node; therefore, code nodename.userid. You cannot code a userid 
without a nodename. 

Note: If a data set is queued for transmission and an operator changes its destination, 
the userid portion of the routing is lost. 

RMnnnn 
RMTnnnn 

Identifies a remote terminal, nnnn is 1 through 4 decimal numbers from 1 through 4000. 

Note: RO is equivalent to LOCAL. 

Unnnn 

Identifies a local terminal with special routing, nnnn is 1 through 4 decimal numbers 
from 1 through 4000. 
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nodename.ymguestid 
nodename:vmguestid 
nodename/vmguestid 
nodename(vmguestid) 

Identifies the network node where the job is to execute. The nodename identifies an MVS 
JES2 system, an MVS JES3 system, a VSE POWER node, or a VM system. If nodename 
specifies the local node, the job executes locally. The nodename is 1 through 8 
alphanumeric, national, or special characters specified during JES2 initialization. 

The vmguestid identifies a guest system running in a virtual machine (VM), for example, 
an MVS system running under VM. Do not specify a work station or terminal in this 
parameter. 

Location in the JCL 

Place the /* ROUTE statement after the JOB statement and either before or after the EXEC 
statements. Place a /* ROUTE XEQ statement before all DD * or DD DATA statements in the 
job. 

Processing of /*ROUTE Statements 

• JES2 processes /*ROUTE XEQ statements on the input node only. 

• When a /*ROUTE PRINT or PUNCH statement follows a /*ROUTE XEQ statement, 
JES2 processes the /* ROUTE PRINT or PUNCH statement on the execution node only. 

• When a /* ROUTE PRINT or PUNCH statement precedes a /* ROUTE XEQ statement, 
JES2 processes the /* ROUTE PRINT or PUNCH statement on both the input and 
execution nodes. However, printing or punching occurs at the node specified on the 
/♦ROUTE PRINT or PUNCH statement. 

Multiple /*ROUTE Statements 

JES2 uses the last /* ROUTE statement of each category, if a job contains more than one 
/*ROUTE PRINT or PUNCH or XEQ statement. 

Examples of the ROUTE Statement 

/*ROUTE PRINT RMT6 

This statement sends the printed output to remote terminal 6. 

/*ROUTE PUNCH PUNCH2 

This statement sends the punched output to device PUNCH2, which was identified to the 
system during initialization. 

/* ROUTE XEQ DENVER 

This statement sends the job to the node named DENVER for execution. 
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/*SETUP Statement 



wse: Use the /* SETUP statement to identify volumes that the operator should mount 
before the job is executed. When the job enters the system, JES2 issues a message to the 
operator console, asking the operator to mount the identified volumes, JES2 then places the 
job in hold status until the operator mounts the volumes and releases the job. 

Syntax: 



/*SETUP serial -number [ , serial-number] . . . 



The /* SETUP statement consists of the characters /* in columns 1 and 2, SETUP in columns 
3 through 7, a blank in column 10, and the volume serial number(s) starting in any column 
from 11 through 71. JES2 ignores columns 72 through 80. 

Do not continue the /* SETUP statement; code as many /* SETUP statements as necessary. 



Parameter Definition 



serial-number 

Identifies by serial number the volume(s). A volume serial number is 1 through 6 
alphanumeric, national, or special characters; enclose a serial number that contains 
special characters, other than hyphens, in apostrophes. If the number is shorter than 6 
characters, it is padded with trailing blanks. 



Location in the JCL 



Place all /*SETUP statements after the JOB statement and before the first EXEC statement. 

To prevent JES2 from requesting mounting of volumes on a node other than the node of 
execution, the /* SETUP statement should follow any /* ROUTE XEQ or /*XEQ statement. If 
JES2 processes the /*SETUP statement before processing a /*ROUTE XEQ or /*XEQ 
statement, JES2 requests the setup on both the input and executic 



Example of the /*SETUP Statement 



/*SETUP 666321,149658 

This statement requests that volumes 666321 and 149658 be mounted for the job. 
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/*SIGNOFF Statement 



Purpose: Use the /*SIGNOFF statement to tell JES2 to end a remote job stream processing 
session. At the completion of the current print and/or punch streams, JES2 disconnects the 
remote work station from the system. If JES2 is reading jobs from the station when the output 
completes, JES2 disconnects the remote station when the input is completed. 

Note: The remote terminal access processor processes the /*SIGNOFF statement if it appears 
in a job stream. 

Both systems network architecture (SNA) and binary synchronous communication (BSC) 
remote work stations can use the /*SIGNOFF statement. SNA remote stations can also use the 
LOGOFF command to end a session with JES2. The LOGOFF command has some options 
that the /*SIGNOFF statement does not provide. 

References: For information on the LOGOFF command, see SPL: JES2 Initialization and 
Tuning and Advanced Communications Function for VTAM Version 2 Programming. 

Syntax: 



/*SIGNOFF 



The /*SIGNOFF statement consists of the characters /* in columns 1 and 2, /*SIGNOFF in 
columns 3 through 9, and blanks in columns 10 through 80. 



Location in the JCL 

The /*SIGNOFF statement can appear anywhere in a local input stream or an input stream 
from a SNA or BSC remote work station. 

Example of the /*SIGNOFF Statement 

/*SIGNOFF 

This statement requests that JES2 terminate a remote job stream processing session. 
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/*SIGNON Statement 



Purpose: Use the /*SIGNON statement to tell JES2 to begin a remote job stream processing 
session. The /*SIGNON statement can override the remote identification number normally 
assigned to the remote work station. This statement is optional for all work stations except 
non-multi -leaving remote stations on a switched hne. For non-multi-leaving remote stations, 
JES2 transmits the /*SIGNON statement alone as part of the initial connection process. 

Note: The remote terminal access processor processes the /*SIGNON statement if it appears in 
a job stream. When the terminal access processor processes the /*SIGNON statement, the line 
being processed is restarted. 

Systems network architecture (SNA) remote work stations must use the LOGON command 
instead of the /*SIGNON statement to notify JES2 of a connection request. 

References: For information on the LOGON command, see SPL: JES2 Initialization and 
Tuning and Advanced Communications Function for VTAM Version 2 Programming. 



Syntax: 



/*SIGNON 



REMOTEnnn 

RMTnnnn 

RMnnnn 



[passwordl] 



[password2] 



The /*SIGNON statement consists the following. Note that all the fields in this statement 
must appear in fixed locations. 

Column Contents 

1-8 /*SIGNON 

16-24 REMOTEnnn or RMTnnnn or RMnnnn beginning in 16 

25-32 passwordl beginning in 25 

73-80 password2 beginning in 73 



Parameter Definition 



REMOTEnnn 

Specifies the identification number assigned to the remote station asking to sign on. The 
nnn is 1 through 3 decimal numbers from 1 through 999. 

Note: Do not code any leading zeroes in nnn. 

Code REMOTEnnn with the same characters as RMTnnn on the /* ROUTE statement. 
If you code REMOTEnnn on the /*SIGNON statement, you are restricted to coding 
RMTnnn with only three numbers on the /* ROUTE statement. 
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RMnnnn 
RMTnnnn 

Specifies a remote station, nnnn is 1 through 4 decimal numbers from 1 through 4000. 

passwordl 

Specifies the password assigned to a switched connection that allows the remote station 
access to JES2 for remote job stream processing. The installation assigns this password 
during JES2 initialization. The operator can change or delete this password with the $T 
command. 

password! 

Specifies the password for the remote station that is signing on; this password identifies 
the remote station as a valid remote job entry (RJE) station. The installation assigns this 
password during JES2 initialization. 



Location in the JCL 

Place the /*SIGNON statement at the start of an input stream to be transmitted from a remote 
work station. 

Place the /*SIGNON statement at the end of the JES2/RTP input stream for multi-leaving 
remote stations. 

Examples of the /*SIGNON Statement 



/*SIGNON REMOTE123PSWD 

This statement requests that remote station 123 begin a remote job stream processing session. 
PSWD, beginning in column 25, is the password assigned to the switched connection. 

/*SIGNON RMTIOOO PSWD 

This statement requests that remote station 1000 begin a remote job stream processing session. 
PSWD, beginning in column 25, is the password assigned to the switched connection. 
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/*XEQ Statement 



Purpose: Use the /*XEQ statement to identify the netv/ork node where the job Is to execute. 
It performs the same function as the /* ROUTE XEQ statement. 

Syntax: 



/*XEQ iNnnnn 

[nodename [ . vmguestid] 



The /*XEQ statement consists of the characters /* in columns 1 and 2, XEQ in columns 3 
through 5, a blank in column 6, and a node starting in any column starting with 7. 



Parameter Definition 



Nnnnn 

Identifies a node, nnnn is 1 through 4 decimal numbers from 1 through 1000. For 
example, NO 103. 

nodename 

Identifies the network node where the job is to execute. The nodename identifies an MVS 
JES2 system, an MVS JES3 system, a VSE POWER node, or a VM system. If nodename 
specifies the local node, the job executes locally. The nodename is 1 through 8 
alphanumeric, national, or special characters specified during JES2 initialization. 

vmguestid 

Identifies a guest system running in a virtual machine (VM), for example, an MVS system 
running under VM. Do not specify a work station or terminal in this parameter. 

Location in tlie JCL 

Place the /*XEQ statement after the JOB statement and either before or after the EXEC 
statements. Place a /*XEQ statement before all DD * or DD DATA statements in the job. 

Multiple /*XEQ Statements 

JES2 uses the last /*XEQ statement, if a job contains more than one /*XEQ statements 



Example of the XEQ Statement 



/*XEQ ATLANTA 

JES2 routes and executes this job on the node defined as ATLANTA. 
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/*XMIT Statement 



Purpose: Use the /*XMIT statement to transmit records from a JES2 node to either another 
JES2 node or an ehgible non-JES2 node, for example, a VM or JES3 node. JES2 does not 
process or check the records for JES2 validity. JES2 builds header and trailer records from 
information on the JOB statement immediately preceding the /*XMIT statement. Then JES2 
transmits all the records following the /*XMIT statement. 

The records may consist of a job input stream or an in-stream DD * or DD DATA data set. If 
the records are a job input stream and the destination node can process JCL, the transmitted 
input stream is executed; in this case, the record immediately following the /*XMIT statement 
must be a JOB statement that is valid at the destination node. 

The records end when JES2 finds one of the following: 

/* in the input stream 

The two-character deUmiter specified by a DLM parameter on this /*XMIT statement 

The input stream runs out of card images 

If the records are being read from an internal reader, the internal reader is closed 



Syntax: 



/*XMIT 



/'Nnnnn 
nodename 
nodename . user id 
nodename : user id 
nodename/userid 
nodename (userid) 
nodename . vmguestid 
nodename : vmguestid 
nodename/vmguestid 
nodename (vmguestid) , 



[ DLM=xx] 



> 



The /*XMIT statement consists of the characters /* in columns 1 and 2, XMIT in columns 3 
through 6, a blank in column 7, a nodename or node-number starting in any column starting 
with 8, and optionally followed, with an intervening blank, by a delimiter parameter. 

Do not continue an /*XMIT statement. 



Parameter Definition 



Nnnnn 



Identifies the destination node, nnnn is 1 through 4 decimal numbers from 1 through 
1000. For example, NO 103. 

nodename 

Identifies the destination node. The nodename identifies an MVS JES2 system, an MVS 
JES3 system, a VSE POWER node, or a VM system. The nodename is 1 through 8 
alphanumeric, national, or special characters specified during JES2 initialization. 
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Defaults 



userid 

Identifies a destination terminal or work station at the node. The userid must be defined 
at the node; userid for TSO is 1 through 7 alphanumeric or national characters and for 
VM is 1 through 8 alphanumeric or national characters. 

Note: If the data set is queued for transmission and an operator changes its destination, 
the userid portion of the original routing is lost. 

vniguestiii 

Identifies a destination guest system running in a virtual machine (VM), for example, an 
MVS system running under VM. Do not specify a work station or terminal in this 
parameter. 

Note: If the data set is queued for transmission and an operator changes its destination, 
the vmguestid portion of the original routing is lost. 

DLM = XX 

Specifies a two-character delimiter to terminate the data being transmitted. 

Code any two characters for the delimiter. If the specified delimiter contains any special 
characters, enclose it in apostrophes. In this case, a special character is any character that 
is neither alphanumeric nor national. 

Failing to code enclosing apostrophes produces unpredictable results. 

If the delimiter contains an ampersand or an apustrophe, code each ampersand or 
apostrophe as two consecutive ampersands or apostrophes. Each pair of consecutive 
ampersands or apostrophes counts as one character. 

If you specify a DLM parameter, you must terminate the transmitted records with the 
characters in the DLM parameter. The characters you assign as delimiters override any 
delimiter imphed by the defaults. 

The characters // are not valid delimiters unless specifically indicated by DLM = //. 



For the end of the records to be transmitted, the default is /* in the input stream. 

If you specify for DLM only one character or more than two characters, JES2 uses /*. 

Location in the JCL 

Place the /*XMIT statement immediately after a JOB statement. 
Code only one /*XMIT statement in a job. 



20-34 MVS/XA JCL Reference 



JES2: /*XMIT 

Examples of the XMIT Statement 

/*XMIT ATLANTA DLM=AA 

JES2 transmits to the node ATLANTA all records following the /*XMIT statement up to the 
specified delimiter, AA. 

/*XMIT VMSYS1.MVS223 
//JOBB JOB 



JES2 transmits the following job stream to the VM guest system, MVS223, running on node 
VMSYSl, which is a VM system. The job stream will be executed by the MVS223 system. 
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JES3 



Chapter 21. JES3 Control Statements 



Code JES3 control statements with JCL statements to control the input and output processing 
of jobs. The rules for coding in Chapter 3, "Format of Statements" and Chapter 4, "Syntax of 
Parameters" apply to the JES3 control statements. 



Location in the JCL 



Place JES3 control statements, except the command and //*PAUSE statements, after the JOB 
statement and its continuations. JES3 ignores JES3 control statements, except the command 
and //*PAUSE statements, that appear before the JOB statement or between continued JOB 
statements. 

Do not include JES3 control statements in a cataloged or in-stream procedure. JES3 ignores 
JES3 control statements in a procedure. 



Internal Reader 



Use the following control statements when submitting jobs to the internal reader. The internal 
reader is described in SPL: JESS Initialization and Tuning, and SPL: System Modifications. 

/*DEL 
/*EOF 
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JES3 

Examples of JES3 Control Statements 



The following shows JES3 control statements in relation to each other and to JCL statements 
for a job entered from a remote work station. No actual job should require all of these 
statements. 

//**MESSAGE,CN1, ENTER A START COMMAND FOR THIS JOB 

//* PAUSE 

//TESTl JOB ,,MSGCLASS=A 

//*NETACCT PNAME=MAEBIRD,ACCT=2K14920 

//*NET NETID=Nl,NHdLD=0 

//*PROCESS CI 

//♦PROCESS MAIN 

//♦PROCESS OUTSERV 

//*DATASET DDNAME=STEP1.DD1 

data 

//*ENDDATASET 

//*ENDPROCESS 

//♦OPERATOR THIS IS TEST JOB TESTl. 

//♦MAIN CLASS=C 

//♦FORMAT PR,DDNAME=STEP1.DD2 ,DEST=ANYL0CAL,C0PIES=2 

//♦ROUTE XEQ NODEl 

//FAR JOB 1 JOB , ,MSGCLASS=A 

//STEPl EXEC PGM=CHECKER 

//DDl DD DSNAME=INPUT 

//DD2 DD SYSOUT=A 

/* 



The following is an ordinary job entered through the local input stream. 

//RUN2 JOB , ,MSGCLASS=A 

//♦MAIN CLASS=B 

//♦FORMAT PR , DDNAME=STEPA . DD2 , DEST=ANYLOCAL , C0PIES=5 

//STEPA EXEC PGM=WRITER 

//DDl DD DSNAME=IN1,DISP=OLD,UNIT=3350,VOLUME=SER=MH2244 

//DD2 DD SYSOUT=A 

/* 
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JES3 Command Statement 

Purpose: Use the command statement to enter a JES3 operator command through the input 
stream. 

JES3 usually executes an in-stream command as soon as it is read. Therefore, the command 
will not be synchronized with the execution of any job or step in the input stream. To 
synchronize a command with job processing, tell the operator the commands you want and 
when they should be issued, then let the operator enter them from the console. 

References: For more information on the command statement and the JES3 verbs and 
operands, see JESS Commands. 

Syntax: 



//** command-verb [ , operand] 



The JESS command statement consists of the characters //** in columns 1 through 4, the 
command verb beginning in column 5, and, if the command requires operands, a comma 
followed by the operands up through column 72. JESS ignores columns 7S through 80. 

Do not continue command statements from one statement to the next. 



Parameter Definition 



*command-verb 

Indicates one of the following JESS commands. Do not specify a *DUMP or *RETURN 
command on a JESS command statement. 



Command 


Short Form 


CALL 


X 


CANCEL 


C 


DELAY 


D 


DISABLE 


H 


ENABLE 


N 


ERASE 


E 


FAIL 




FREE 




INQUIRY 


I 


MESSAGE 


Z 


MODIFY 


F 


RESTART 


R 


SEND 


T 


START 


S 


SWITCH 




VARY 


V 



operand 

Specifies an operand that pertains to the command-verb. 
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Location in tlie JCL 

• Place all command statements before the first JOB statement in the input stream, if jobs are 
also being submilted. JESS treats any command statements that follow the JOB statement 
as comment statements. 

• You can enter several command statements at one time. 

• You can place command statements at the beginning of the cards in an active card reader 
that is being restarted. 

• Command statements can be entered through card, tape, or disk readers. 

• Command statements cannot be entered through an internal reader or from another node. 

Examples of the Command Statement 



//* * VARY ,280, OFFLINE 
//**V, 281, OFFLINE 
//**VARY,282,OFF 

//**V, 280-282, OFF 

In this example, the first three statements each vary one device offline. Alternatively, the fourth 
statement varies all three devices offljrie. If you place these cards in card reader OIC, for 
example, and it is currently not in use, the operator would enter through the operator console: 

*X CR,IN=01C 



//**MESSAGE,CN1, OUTPUT FROM JOB X REQUIRES SPECIAL CONTROLS 

This statement instructs the operator from a remote location. Place this statement before the 
first job in the input stream. 
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//*DATASET Statement 



Purpose: Use the //*DATASET statement to identify the beginning of an in-stream data set, 
which can contain JCL and/or data. The data set can be used as input to a dynamic support 
program (DSP), such as OUTSERV. 

Note: Make sure the operator includes a C operand on the *CALL command for the reader 
that reads a job containing this statement if it contains a MODE = C parameter. 



Syntax: 



//*DATASET DDNAME= 



stepname . ddname 

stepname .procstepname . ddname 



[ , parameter ] . . 



The parameters are: 



MODE= 



YES 
NO 



CLASS = 



NO 
MSGCLASS 

class 



The //*DATASET statement consists of the characters //* in columns 1 through 3, 
DATASET in columns 4 through 10, a blank in column 11, and parameters in colujnns 12 
through 72. JES3 ignores columns 73 through 80. 



Parameter Definition 



DDNAME = stepname.ddname 

DDNAME = stepname.procstepname.ddname 

Identifies the DD statement that defines the spooled data set. Use form stepname.ddname 
to indicate DD statement, ddname, in step, stepname, in this job. Use form 
stepname.procstepname.ddname to indicate DD statement, ddname, in procedure step, 
procstepname, of a procedure that is called by a step, stepname, in this job. The ddname 
must match exactly the ddname on the DD statement. 

MODE=E 
MODE=C 

Defines the card-reading mode. 



E 



Indicates that JES3 is to read the cards as EBCDIC with vahdity checking. E is the 
default if the MODE parameter is omitted. 



Indicates that JES3 is to read the cards in card image form, that is, in column 
binary or data mode 2. 

MODE = C is not valid for jobs read from disk or tape, or for jobs submitted from 
remote work stations. 



Chapter 21. JESS Control Statements 21-5 



JES3: //*DATASET 



J = YES 

J = NO 

Indicates how JES3 is to recognize the end of the data set. 

If you specify MODE = C, JES3 ignores the J parameter; therefore, use a 
//♦ENDDATASET statement to end the data set. 

YES 

Indicates that a //*ENDDATASET statement ends the data set. Specify YES when 
JOB statements appear in the data set. 

NO 

Indicates that a JOB statement ends the data set. NO is the default if the J 
parameter is omitted, unless MODE = C is specified. 

CLASSING 
CLASS = MSGCLASS 

CLASS = class 

Identifies the output class JES3 is to use for the data set. 

NO 

Indicates that the system is to assign an output class. If you omit the CLASS 
parameter, the default is NO. 

MSGCLASS 

Requests the output class in the MSGCLASS parameter on the JOB statement. 

class 

Specifies the output class. 

Location in the JCL 

Place a //*DATASET statement immediately before the first record of an in-stream data set. 
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Examples of the //*DATASET Statement 



//♦PROCESS OUTSERV 

//*DATASET DDNAME=STEP3 . MYPRINT , J=YES 



data 



//*ENDDATASET 

//*FORMAT PR , DDNAME=STEP3 . MYPRINT , C0PIES=5 

//STEPl EXEC . . . 



//STEP3 EXEC . . . 

//MYPRINT DD DSNAME=REPORT 



In this example, the //*DATASET statement marks the beginning of the in-stream data set 
MYPRINT. The //*FORMAT PR statement requests five copies of it. A //*ENDDATASET 
statement marks the end of the data set. 



//JOBl JOB 

//MYPRC PROC 

//PROCl EXEC PGM=FETCH 

//DD6 DD DSNAME=TYPE2 



// PEND 

//STEPl EXEC PROC=MYPRC 



//*DATASET DDNAME=STEP 1 . PROCl . DD6 , J=YES 



data 



//*ENDDATASET 
//STEP2 EXEC PGM=A 

In this example, the //*DATASET statement marks the beginning of the in-stream data set 
defined in DD statement DD6. Note the qualification in the ddname: STEPl identifies the 
EXEC statement that calls the in-stream procedure, PROCl is the procedure step that contains 
the DD statement, and DD6 is the ddname of the DD statement. The end of the data set is 
indicated by a //*ENDDATASET statement. 
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//*ENDDATASET Statement 

Furpose: Use the /7*ENDDATASET statement to indicate the end of an in-stream data set 
that was begun with a //*DATASET statement. 

Syntax: 



//*ENDDATASET 



The //*ENDDATASET statement consists of the characters //* in columns 1 through 3 and 
ENDDATASET in columns 4 through 13. Columns 14 through 80 must be blank. 



Location in the JCL 

Place a //*ENDDATASET statement immediately after the last record of an in-stream data set 
that was begun with a //*DATASET statement. 

Example of the //*ENDDATASET Statement 



//*DATASET DDNAME= INFO, J= YES 

data 
//* ENDDATASET 

In this example, the //*ENDDATASET statement marks the end of the in-stream data set 
INFO. 
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//*ENDPROCESS Statement 



Purpose: Use the //*ENDPROCESS statement to indicate the end of a series of //*PROCESS 
statements in a job. 

Syntax: 



//*ENDPROCESS [comments] 



The //*ENDPROCESS statement consists of the characters //* in columns 1 through 3, 
ENDPROCESS in columns 4 through 13, a blank in column 14, and, optionally, conunents 
starting in any column beginning with 15. JES3 ignores columns 73 through 80. 



Location in the JCL 

Place a //*ENDPROCESS statement immediately after the last //*PROCESS statement in a 
job. The //*ENDPROCESS statement is optional if a JCL statement follows the last 
//♦PROCESS statement. 

Do not place any //*PROCESS statements after the //*ENDPROCESS statement. 
Example of the //*ENDPROCESS Statement 

//*ENDPROCESS END OF PROCESS STATEMENTS 
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//*FORMAT PR Statement 

Purpose: Use the //*FORMAT PR statement to specify to JES3 processing instructions for 
sysout data sets that are printed. These instructions permit special processing of sysoiit data 
sets, such as: 



• Multiple destinations. 

• Multiple copies of output with different attributes. 

• Forced single or double space control. 

• Printer overflow checking. 

You can code several //* FORMAT PR statements for one sysout data set to specify special 
requirements for different copies of the data set. You can also code a //* FORMAT PU 
statement for the same sysout data set, thereby both printing and punching it. 

Note: The //*FORMAT PR statement apphes only to sysout data sets printed by JES3. The 
statement is ignored for data sets sent to a TSO userid or processed by an external writer. 

Syntax: 



//* FORMAT PR,DDNAME= 



'stepname . ddname 
stepname .procstepname . ddname 
<SYSMSG 
JESuCIi 
JESMSG 



[ , parameter] . . 



//♦FORMAT PR,DDNAME=[ , parameter] . . . 

The parameters are: 

CARRIAGE= carriage-tape-name 

[6 
FCB= I image-name 
6 



CHARS= 



STANDARD 

table-name 

(table-name [ , table-name] 



r'H\TQT'7T?= n5? 



) 



I (nnn[ ,mmm] )| 
COMPACT=compact ion-table-name 



CONTROL= 



PROGRAM 



COPIES= 



. SINGLE 
DOUBLE 
TRIPLE 

nnn 

( nnn , ( group-value [ , group-value ]...)) 

(group-value [ , group-value] . . . ) 
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ANYLOCAL 
device-name 
device-number 
^ group -name 
DEST=|nodename[ .remote] 

(type [ , device-name] ) 
( type [ , device-number ] ) 
J type [ , group-name] ) 

EXTWTR=name 



FLASH= 



FORMS = 



STANDARD 



overlay-name 

( over lay-name [ , count ] ) 



STANDARD 



form-name 



MODIFY= jmodule-name 

I (module-name [ ,trc] ) 



OVFL= 



ON 

OFF 



PRTY=nnn 



STACKER= 



STANDARD 

S 

C 



THRESHLD=limit 



TRAIN= 



STANDARD 



train-name 



The //* FORMAT PR statement consists of the characters //* in columns 1 through 3, 
FORMAT in columns 4 through 9, a blank in column 10, PR in columns 1 1 and 12, a 
comma in column 13, and parameters in columns 14 through 72. JES3 ignores columns 73 
through 80. 



Parameter Definition 
PR 



Indicates that this statement is associated with a sysout data set that is printed. 
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DDNAME = 

DDNAME = stepname.ddname 

DDNAME = stepname.procstepname.ddname 

DDNAME = SYSMSG 

DDNAME = JESJCI. 

DDNAME = JESMSG 



(null) 

Specifies that the parameters on this //* FORMAT PR statement are the defaults for 
the job. These parameters then apply to all of the job's sysout data sets that are 
printed, except those covered by a //*FORMAT PR statement with 
DDNAME = ddname. 

Nonspecific and Specific Statements: A //* FORMAT PR statement that contains 
DDNAME = is called nonspecific; a statement that contains DDNAME = ddname 
is called specific. 

Overrides: Parameters coded on a nonspecific //* FORMAT PR statement are 
overridden by parameters coded on sysout DD statements or by parameters in the 
JES3 SYSOUT initialization statement. 

stepname.ddname 
stepname.procstepname.ddname 

Identifies the DD statement that defines the sysout data set to be printed. Use form 
stepname.ddname to indicate DD statement, ddname, in step, stepname, in this job. 
Use form stepname.procstepname.ddname to indicate DD statement, ddname, in 
procedure step, procstepname, of a procedure that is called by a step, stepname, in 
this job. The ddname must match exactly the ddname on the DD statement. (See 
the example for the /7*DATASET statement.) If the identified DD statement does 
not contain a SYSOUT parameter, JES3 ignores the //* FORMAT PR statement. 

SYSMSG 

Requests printing of system messages. 

JESJCL 

Requests printing of JCL statements and messages. 

JESMSG 

Requests printing of JES3 and operator messages about the job. 

CARRIAGE = carriage-tape-name 
CARRIAGE = 6 

Specifies the carriage tape for the 3211, 3203 Model 5, or 1403 Printer for printing this 
output class. 

carriage-tape-name 

Identifies the name of the carriage tape. The name is 1 through 8 characters. 

For the 3211 and 3203-5, SYSl.IMAGELIB must contain a module for each 
carriage tape name. 



Indicates the installation standard carriage tape. 
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Note: You cannot code both the CARRIAGE and FCB parameters on the same 
//* FORMAT PR statement. 

CHARS = STANDARD 

CHARS = table-name 

CHARS = (table-nanie|,table-name]...) 

Requests one or more character-arrangement tables for printing the sysout data set on a 
3800 Printing Subsystem. 

STANDARD 

Indicates the standard character-arrangement table, which was specified at JES3 
initialization. 

table-name 

Identifies a character-arrangement table. Each table-name is 1 through 4 
alphanumeric or national characters. When coding more than one table-name, 
parentheses are required around the list and null positions are invahd in the list. 

CHNSIZE = DS 
CHNSIZE = (nnn[,mmml) 

Gives the number of logical records to be transmitted to a work station as a systems 
network architecture (SNA) chain and indicates whether normal output checkpoints are to 
be taken for this sysout data set. 

Note: This parameter is valid only when transmitting to a SNA work station. 

Be careful in selecting subparameters, because each affects performance differently. 
Sending the data set as a SNA chain provides the best performance, but can cause 
duplicate data to be written to the output device if operator intervention is required. The 
remote operator can eliminate duplicate data by issuing commands to reposition and 
restart the output writers. 

When an end-of-chain indicator is sent in the data set, JES3 takes an output checkpoint. 
You can provide additional checkpoints for critical data by sending an end-of-chain 
indicator. For example, when printing bank checks, you can have an output checkpoint 
taken for each check by specifying each check as a SNA chain. 

DS 

Indicates that the sysout data set is to be sent as a single SNA chain and that JES3 
is to take normal output checkpoints. DS is the default if the CHNSIZE parameter 
is omitted. 

nnn 

Specifies the SNA chain size in pages, nnn is a decimal number from I through 
255. The size of a page is determined by: 

• The value of mmm, 

# The carriage control characters in the data that skip to channel 1. 

mmm 

Specifies the number of logical records in a page, when the data contains no 
carriage control characters, mmm is a decimal number from 1 through 255. 
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COMPACT == compaction-table-name 

Specifies the compaction table for JES3 to use when sending a systems network 
architecture (SNA) data set to a SNA remote terminal. The compaction-table-name is a 
symbolic name defined by the installation during JES3 initialization. The name is 1 
through 8 alphanumeric characters. 

In the following cases, JES3 performs compaction using an installation default table, if 
defined, or sends the data without compacting it, if no table was defined. In all cases, 
JESS writes a message to the console. 

• No compaction table is specified. 

• The specified compaction table is invalid. 

• JES3 cannot find the specified compaction table. 

If the remote printer does not support compaction, JES3 ignores the COMPACT 
parameter and sends the data without compacting it. 

CONTROL = PROGRAM 

CONTROL = SINGLE 
CONTROL = DOUBLE 
CONTROL = TRIPLE 

Indicates either that the data records control printing or that the output is to be printed 
with single, double, or triple spacing. 

PROGRAM 

Indicates that each logical record in the sysout data set begins with a carriage 
control character. The carriage control characters can be in either the extended 
USASCII code or can be the actual channel command code. The carriage control 
characters are given in the Data Administration Guide. 

SINGLE 

Requests single spacing. 

DOUBLE 

Requests double spacing. 

COPIES = nnn 

COPIES = (nnn,(group-vaiiie[,group-value]...)) 

COPIES = (group-value(,group-value]...) 

Indicates how many copies of the sysout data set are to be printed. If a COPIES 

parameter is not specified, the default is 1. 



nnn 



Specifies how many copies of the sysout data set are to be printed; each copy will be 
in page sequence order, nnn is a number from through 255. If you code 
COPIES = 0, JES3 does not print this data set. You can omit the parentheses if you 
code only nnn. JES3 ignores nnn if any group-values are specified. 
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group-value 

Specifies how many copies of each page are to be printed before the next page is 
printed. Each group-value is a number from 1 through 255. You can code a 
maximum of eight group-values. Their sum must not exceed 255. The total copies 
of each page equals the sum of the group-values. 

This subparameter is valid only for output on a 3800 Printing Subsystem. Group 
values override an nnn subparameter. 

DEST" destination 

Routes the output from the sysout data set to a printer. This parameter overrides the 
//*MAIN statement ORG parameter. 

If you omit DEST, JES3 assigns the first available printer that is in the origin group and 
that fulfills all processing requirements. The origin group is the group of printers defined 
for the local or remote submitting location. If the job originated at a remote job 
processing (RJP) terminal, JES3 returns the output to the originating terminal group. 

ANYLOCAL 

Indicates any local printer that is being used for the output class specified in the 
SYSOUT parameter on the DD statement and that is attached to the global 
processor. 

device-name 

Requests a local device by a symbolic name defined by the installation during JES3 
initialization, device-name is 1 through 8 alphanumeric or national characters. 

device-number 

Specifies the 3 -character device number. 

group-name 

Identifies a group of local devices, an individual remote station, or a group of 
remote stations by a symbolic name defined by the installation during JES3 
initialization, group-name is 1 through 8 alphanxmieric or national characters. 

nodename 

Identifies a node by a symbolic name defined by the installation during JES3 
initiahzation. nodename is 1 through 8 alphanumeric or national characters. 

remote 

Identifies a remote work station or VM userid to which the receiving node directs 
output, remote is 1 through 8 characters. 

(type) 

Indicates a device classification, type is in the form (gggssss) where ggg is the 
general device classification and ssss is the specific device classification. The type 
must be enclosed in parentheses. The type must be defined by the installation 
during JES3 initialization. For example, type for a 3800 is (PRT3800). 

EXTWTR = name 

Identifies the external writer that is to process the sysout data set at the destination node, 
name is 1 through 8 alphanumeric characters and must identify a module defined to the 
remote JES3 node that is to execute the job. 
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FCB = image-name 
FCB = 6 

Specifies the forms control buffer (FCB) image JES3 is to use to guide printing of the 
sysout data set by a 3211 Printer, 3203 Printer Model 5, or 3800 Printing Subsystem or by 
a printer supported by systems network arehitectiire (SNA) remote job processing (RJP). 

If the data set is to be produced on some other device, JES3 ignores the FCB parameter. 

image-^naine 

Identifies the FCB image. The name is 1 through 4 alphanumeric or national 
characters and is the last characters of a SYSl.IMAGELIB member name: 

• FCB2XXXX member for a 3211, 3203 model 5, or printer supported by SNA. 

• FCB3XXXX member for a 3800. 

• FCB4XXXX member for a 4248. 



Indicates the standard FCB. JES3 uses the standard FCB specified at JES3 
initiahzation. 

Note: You cannot code both the CARRIAGE and FCB parameters on the same 
//*FORMAT PR statement. 

FLASH = STANDARD 

FLASH = overlay-name 

FLASH = (overIay-name[,countl) 

Identifies the forms overlay to be used in printing the sysout data set on a 3800 Printing 
Subsystem and, optionally, to specify the number of copies on which the forms overlay is 
to be printed. 

You can omit the parentheses if you code only an overlay-name. If you omit the count 
subparameter or specify a count of 0, JES3 flashes all copies with the specified overlay. 

STANDARD 

Indicates the standard forms flash overlay. JES3 uses the standard forms overlay 
specified at JES3 initialization. 

overlay-name 

Identifies the forms overlay frame that the operator is to insert into the printer 
before printing begins. The name is 1 through 4 alphanumeric or national 
characters. 

count 

Specifies the number, through 255, of copies that JES3 is to flash with the overlay, 
beginning with the first copy printed. Code a count of to flash all copies. 

Note: See the Forms Design Reference Guide for the IBM 3800 Printing Subsystem for 
information on designing and making forms overlays. 
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FORMS = STANDARD 
FORMS = form-name 

Indicates the forms on which the sysout data set is to be printed. 

STANDARD 

Indicates the standard form. JESS uses the standard form specified at JES3 
initialization. 

form-name 

Names the print forms, form-name is 1 through 8 alphanumeric characters. 

MODIFY = module-name 
MODIFY = (moduIe-name[,trc]) 

Specifies a copy modification module that tells JESS how to print the sysout data set on a 
3800 Printing Subsystem. The module can specify how to replace blanks or data in the 
data set. You can omit the parentheses if you code only a module-name. 

The module is defined and stored in SYSl.IMAGELIB using the lEBIMAGE utility 
program. See the Data Administration: Utilities for more information. 

If you omit the trc subparameter, JESS prints the data set with the first 
character-arrangement table coded in the CHARS parameter. 

module-name 

Identifies a copy modification module in SYSl.IMAGELIB. module-name is 1 
through 4 alphanumeric or national characters. 

trc 

Identifies which table-name in the CHARS parameter is to be used. This table 
reference character is for the first table-name specified, 1 for the second, 2 for the 
third, or S for the fourth. 

OVFL = ON 
OVFL = OFF 

Indicates whether or not the printer program should test for forms overflow. 

Because the overflow test is a responsibility of the terminal package for the remote RJP 
terminal, JESS ignores OVFL for remote job processing. 

ON 

Indicates that the printer program should eject whenever the end-of-forms indicator 
(channel 12) is sensed. ON is the default if the OVFL parameter is omitted. 

OFF 

Indicates that forms overflow control is not to be used. 

PRTY = nnn 

Specifies the priority at which the sysout data set enters the output queue, nnn is a 
decimal number from through 255; is the lowest priority while 255 is the highest. 
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STACKER = STANDARD 
STACKER =S 
STACKER =C 

Requests a stacker for 3800 Printing Subsystem output. 

STANDARD 

Indicates the standard installation default. This default is specified at JES3 
initiaHzation. 



Indicates the burster-trimmer-stacker, in which the output is burst into separate 
sheets. 



Indicates the continuous forms stacker, in which the output is left in continuous 
fanfold. 

THRESHLD = limit 

Specifies the maximum size for the sysout data set. JESS calculates the sysout data set 
size as the number of records multiplied by the number of copies requested. When this 
size exceeds the THRESHLD value, JES3 creates a new unit of work, on a data set 
boundary, and queues it for printing. Consequently, copies of the sysout data set may be 
printed simultaneously by different printers. 

Use the THRESHLD parameter for jobs that generate many large sysout data sets. 
Grouping data sets as a single unit of work for an output service writer may decrease the 
time required for the output service writer to process the data sets. 

The value specified in this parameter overrides the value specified during JES3 
initialization. 

limit 

Specifies the maximum records for a single sysout data set. limit is a decimal 
number from 1 through 99999999. The default is 99999999. 

TRAIN = STANDARD 
TRAIN == train-name 

Indicates the printer train to be used in printing the sysout data set. See Figure 10-2 on 
page 10-140 for the IBM-supplied trains. Because these trains are not standard machine 
features, verify that the installation has the required printer train before specifying it. 

Do not code the TRAIN parameter for output destined for a remote job processing (RJP) 
terminal. 

STANDARD 

Indicates the standard installation default. This default is specified at JES3 
initialization. 

train-name 

Specifies an installation-supplied printer train. Check with your installation for the 
names of trains. 
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Relationship to Sysout DD and OUTPUT JCL Statements 



• JES3 ignores the processing options specified on a default //*FORMAT statement when a 
sysout DD statement explicitly or implicitly references an OUTPUT JCL statement. 

• JES3 ignores the processing options specified on a default OUTPUT JCL statement when a 
//*FORMAT statement explicitly references a sysout DD statement. 

• When a sysout DD statement explicitly references an OUTPUT JCL statement and a 
//*FORMAT statement explicitly references the same DD statement, the processing options 
from both the OUTPUT JCL and //*FORMAT statements apply. Two separate sets of 
output are created from the data set defined by the sysout DD statement; one according to 
the processing options on the OUTPUT JCL and DD statements, and the other according 
to the processing options on the //*FORMAT and DD statements. 

Relationship to //*PROCESS Statement 

JES3 accumulates //*FORMAT PR statements within a job and applies them to any JES3 
//♦PROCESS statement that is normally affected by a //*FORMAT PR statement. 

Location in the JCL 

Place all //*FORMAT PR statements for the job after the JOB statement and before the first 
EXEC statement. 

Examples of the //^FORMAT PR Statement 



//*FORMAT PR , DDNAME=STEP1 . REPORT , C0PIES=2 

This statement requests two copies of the data set defined by sysout DD statement REPORT, 
which appears in STEPl of this job. Any printer with standard forms, train, and carriage tape 
can be used. 

//*FORMAT PR , DDNAME= , DEST=ANYLOCAL 

This statement specifies that all sysout data sets not referenced by //*FORMAT PR statements 
are to be printed on any local printer. 
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//*FORMAT PU Statement 

Purpose: Use the //*FORMAT PU statement to specify to JESS processing instructions for 
sysoiit data sets that are punched. These instructions permit special processing of sysout data 
sets, such as: 

• Multiple destinations. 

« Multiple copies of output with different attributes. 

You can code several //* FORMAT PU statements for one sysout data set to specify special 
requirements for different copies of the data set. You can also code a //*FORMAT PR 
statement for the same sysout data set, thereby both printing and punching it. 

Note: The //*FORMAT PU statement apphes only to sysout data sets punched by JES3. The 
statement is ignored for data sets sent to a TSO userid or processed by an external writer. 



Syntax: 



//*FORMAT PU,DDNAME= 



stepname . ddname 

stepname .procstepname . ddname 



[ , parameter] . . . 



//*FORMAT PU,DDNAME=[ , parameter] . . 
The parameters are: 



CHNSIZE= 



PS 

(nnn[ ,mmm] ) 



COMPACT=compact ion- table-name 



COPIES=nnn 
/ 



DEST= 



ANYLOCAL 
device-name 
device-number 
group-name 



nodename [ . remote ] 
(type [, device-name ]) 
(type [ , device-number] ) 



EXTWTR=name 



FORMS = 



STANDARD 



form-name 



INT= 



YES 
NO 



The //* FORMAT PU statement consists of the characters //* in columns 1 through 3, 
FORMAT in columns 4 through 9, a blank in column 10, PU in columns 11 and 12, a 
comma in column 13, and parameters in columns 14 through 72. JES3 ignores columns 73 
through 80. 
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Parameter Definition 
PU 



Indicates that this statement is associated with a sysout data set that is punched. 

DDNAME = 

DDNAME = stepname.ddname 

DDNAME = stepnaine.procstepname.ddname 



(null) 

Specifies that the parameters on this //* FORMAT PU statement are the defaults for 
the job. These parameters then apply to all of the job's sysout data sets that are 
punched, except those covered by a //* FORMAT PU statement with 
DDNAME = ddname. 

Nonspecific and Specific Statements: A //* FORMAT PU statement that contains 
DDNAME = is called nonspecific; a statement that contains DDNAME = ddname 
is called specific. 

Overrides: Parameters coded on a nonspecific //* FORMAT PU statement are 
overridden by parameters coded on sysout DD statements or by parameters in the 
JES3 SYSOUT initiahzation statement. 

stepname.ddname 
stepname.procstepname.ddname 

Identifies the DD statement that defines the sysout data set to be punched. Use 
form stepname.ddname to indicate DD statement, ddname, in step, stepname, in this 
job. Use form stepname.procstepname.ddname to indicate DD statement, ddname, in 
procedure step, procstepname, of a procedure that is called by a step, stepname, in 
this job. The ddname must match exactly the ddname on the DD statement. (See 
the example for the //*DATASET statement.) If the identified DD statement does 
not contain a SYSOUT parameter, JES3 ignores the //*FORMAT PU statement. 

CHNSIZE = DS 

CHNSIZE = (nnn[,mmml) 

Gives the number of logical records to be transmitted to a work station as a systems 
network architecture (SNA) chain and indicates whether normal output checkpoints are to 
be taken for this sysout data set. 

Note: This parameter is valid only when transmitting to a SNA work station. 

Be careful in selecting subparameters, because each affects performance differently. 
Sending the data set as a SNA chain provides the best performance, but can cause 
duplicate data to be written to the output device if an operator intervention is required. 
The remote operator can eliminate dupUcate data by issuing commands to reposition and 
restart the output writers. 

When an end-of-chain indicator is sent in the data set, JES3 takes an output checkpoint. 
You can provide additional checkpoints for critical data by sending an end-of-chain 
indicator. For example, when punching bank checks, you can have an output checkpoint 
taken for each check by specifying each check as a SNA chain. 
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DS 

Indicates that the sysout data set is to be sent as a single SNA chain and that JES3 
is to take normal output checkpoints. DS is the default if the CHNSIZE parameter 
is omitted. 

nnn 

Specifies the SNA chain size in pages, nnn is a decimal number from 1 through 
255. The size of a page is determined by the value you assign to mmm. 

mmm 

Specifies the number of logical records in a page, mmm is a decimal number from 1 
through 255. 

COMPACT = compaction-table-name 

Specifies the compaction table for JES3 to use when sending a systems network 
architecture (SNA) data set to a SNA remote terminal. The compaction-table-name is a 
symboUc name defined by the installation during JES3 initialization. The name is 1 
through 8 alphanumeric characters. 

In the following cases, JESS performs compaction using an installation default table, if 
defined, or sends the data without compacting it, if no table was defined. In all cases, 
JESS writes a message to the console. 

• No compaction table is specified. 

• The specified compaction table is invalid. 

• JESS cannot find the specified compaction table. 

If the remote punch does not support compaction, JESS ignores the COMPACT 
parameter and sends the data without compacting it. 

COPIES = nnn 

Indicates how many copies of the sysout data set are to be punched, nnn is a number 
from through 255. If you code COPIES = 0, JESS does not punch this data set. If a 
COPIES parameter is not specified, the default is 1 . 

DEST = destination 

Routes the output from the sysout data set to a punch. This parameter overrides the 
/7*MAIN statement ORG parameter. 

If you omit DEST, JESS assigns the first available punch that is in the origin group and 
that fulfills all processing requirements. The origin group is the group of punches defined 
for the local or remote submitting location. If the job originated at a remote job 
processing (RJP) terminal, JESS returns the output to the originating terminal group. 

ANYLOCAL 

Indicates any local punch that is being used for the output class specified in the 
SYSOUT parameter on the DD statement and that is attached to the global 
processor. 

device-name 

Requests a local device by a symbolic name defined by the installation during JESS 
initialization, device-name is 1 through 8 alphanumeric or national characters. 
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device-number 

Specifies the 3 -character device number. 

group-name 

Identifies a group of local devices, an individual remote station, or a group of 
remote stations by a symbolic name defined by the installation during JES3 
initialization, group-name is 1 through 8 alphanumeric or national characters. 

nodename 

Identifies node by a symbolic name defined by the installation during JES3 
initialization. nodeAame is 1 through 8 alphanumeric or national characters. 

remote 

Identifies a remote work station or VM userid to which the receiving node directs 
output, remote is 1 through 8 characters. 

(type) 

Indicates a device classification, type is in the form (gggssss) where ggg is the 
general device classification and ssss is the specific device classification. The type 
must be enclosed in parentheses. The type must be defined by the installation 
during JES3 initialization. For example, type for a 3525 is (PUN3525). 

EXTWTR = name 

Identifies the external writer that is to process the sysout data set at the destination node, 
name is 1 through 8 alphanumeric characters and must identify a module defined to the 
remote JES3 node that is to execute the job. 

FORMS = STANDARD 
FORMS = form-name 

Indicates the forms on which the sysout data set is to be punched. 

STANDARD 

Indicates the standard form. JES3 uses the standard form specified at JES3 
initiaUzation. 

form-name 

Names the punch forms, form-name is I through 8 alphanumeric characters. 

INT = YES 
E^ = NO 

Specifies whether or not the output is to be interpreted. If the INT parameter is omitted, 
the default is NO. 

YES 

Requests that JES3 try to punch the sysout data set on a 3525 Card Punch 
(PUN3525I) with a Multiline Card Print feature. 

Note: If the DEST parameter does not send output to a 35251, JES3 ignores 
INT = YES, if specified. 

NO 

Requests that the cards not be interpreted. 
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Relationship to Sysout DD and OUTPUT JCL Statements 

• JES3 ignores the processing options specified on a default //* FORMAT statement when a 
sysout DD statement expHcitly or implicitly references an OUTPUT JCL statement. 

• JES3 ignores the processing options specified on a default OUTPUT JCL statement when a 
//* FORMAT statement explicitly references a sysout DD statement. 

© When a sysout DD statement explicitly references an OUTPUT JCL statement and a 

//* FORMAT statement explicitly references the same DD statement, the processing options 
from both the OUTPUT JCL and //*FORMAT statements apply. Two separate sets of 
output are created from the data set defined by the sysout DD statement; one according to 
the processing options on the OUTPUT JCL and DD statements, and the other according 
to the processing options on the //*FORMAT and DD statements. 

Relationship to //*PROCESS Statement 

JES3 accumulates //*FORMAT PU statements within a job and applies them to any JES3 
//*PROCESS statement that is normally affected by a //* FORMAT PU statement. 

Location in the JCL 

Place all //*FORMAT PU statements for the job after the JOB statement and before the first 
EXEC statement. 

Example of the //*FORMAT PU Statement 



//*FORMAT PU , DDNAME=STEP2 . PUNCHOUT , DEST=PU1 , FORMS=RED-STRP 

This statement requests that one copy of the data set defined by sysout DD statement 
PUNCHOUT in STEP2 of this job be punched on device PUl. Before processing, the operator 
is requested to insert RED-STRP cards into the punch. 
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//*MAIN Statement 



Purpose: Use the //*MAIN statement to define the processor requirements for the current job. 
Many of the parameters are used to override parameters on the JES3 STANDARDS 
initialization statement. 

Note: If any parameter is misspelled or contains an invalid value, JES3 writes the following to 
the JESMSG data set: the //*MAIN statement, the relative error position on the statement, 
and an error message. Then JES3 abnormally terminates the job. 



Syntax: 



//*MAIN parameter [, parameter] 
The parameters are: 



ACMAIN=processor-id 



BYTES= 



( [nnnnnn] 
( [nnnnnn] 
{ [nnnnnn] 
( [nnnnnn] 
( [nnnnnn] 
(, [nnnnnn] 



, WARNING] ) 

,W] ) 

, CANCEL] ) 

,C]) 

, DUMP ] ) 

,D] ) 



CARDS= 



( [nnnn] [, WARNING] 

( [nnnn] [ ,W] ) 

{ [nnnn] [, CANCEL] ) 

( [nnnn] [ ,C] ) 

( [nnnn] [,DUMP] ) 

(, [nnnn] [ ,D] ) 



CLASSIC lass-name 



DEADLINE= 



EXPDTCHK= 



(time, type [ ,date] ) 
(time, type [ ,r el, cycle] ) 



YES 



NO 



FAILURE= RESTART 
CANCEL 
HOLD 
PRINT 



FETCH= Call 

NONE 

SETUP 

( ddname [ , ddname ] . 

/ ( ddname [ , ddname ] 



HOLD= 



YES 
NO 



IORATE= 



JOURNAL= 



MED 

HIGH 

LOW 

YES 
NO 
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LINES= ( [nnnn] 
[nnnn] 
[nnnn] 
[nnnn] 
[nnnn] 
[nnnn] 

LREGION=nnnnK 

MSS=jJOBj 

Ihws) 



, WARNING] ) 

,W]) 

, CANCEL] ) 

,C]) I 

,DUMP]) 

,D]) ) 



ORG — 



group -name 
nodename [ . remote ] 



PAGES= 



[nnnnnnnn] 
[nnnnnnnn] 
[nnnnnnnn] 
[nnnnnnnn] 
[nnnnnnnn] 
[nnnnnnnn] 



.WARNING] ) 

,W]) 

, CANCEL] ) 

,C]) 

,DUMP] ) 

,D] ) 



PROC= 



ST 
XX 



RINGCHK= YES 
[NO 

/ 

SETUP= JOB 
HWS 
THWS 
.DHWS 
{ stepname . ddname [ , stepname . ddname J . . . ) 

(stepname.procstepname.ddname[ ,stepname.procstepname. ddname] . 
/ ( stepname . ddname [ , stepname . ddname ] . . . ) 
/ ( stepname .procstepname . ddname [ , stepname .procstepname « ddname] 

SPART=p art it ion-name 



.) 



SYSTEM= 



ANY 



JGLOBAL 
( JLOCAL 
(main-name [ , main-name] . . .] 
/ (main-name [ , main-name] . . . )^ 



TRKGRPS=(primary-qty,second-qty) 
TYPE= [any 



[VS2 

UPDATE=(dsname[ ,dsname] . . . ) 
USER=userid 



Tlie //*MAIN statement consists of the characters //* in columns 1 tlirough 3, MAIN in columns 4 
through 7, a blank in colimin 8, and parameters in columns 9 through 72. JESS ignores columns 73 
through 80. 
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Parameter Deflnitioii 



ACMABV = processor-id 

Identifies the job with the specified processor, even though the job was not submitted 
from or executed on that processor. This parameter has no effect if it specifies the 
processor that the job runs on. ACMAIN allows: 

• Sysout data sets to be sent to a userid attached to the specified processor. The userid 
must be named in the USER parameter. The ACMAIN parameter appUes to all 
sysout data sets for the job. 

• A job termination message to be sent automatically to a userid attached to the 
specified processor. The userid must be named in the JOB statement NOTIFY 
parameter. 

processor-id 

Requests a processor in the complex. 

BYTES = (lnnnniinlI,WARNINGl) 
BYTES = (lnnnnnnl[,Wl) 
BYTES = (innnnnnll,CANCELl) 
BYTES = ([nnnnniil[,C|) 
BYTES = annnnnnn.DUMPl) 
BYTES = ([nnnnnni(,Dl) 

Specifies the maximum number of bytes of data to be spooled from this job's sysout data 

sets and the action to be taken if the maximum is exceeded. 

If BYTES is not specified, the installation default for this job class applies. 

nnnnnn 

Specifies the number of bytes in thousands, nnnnnn is 1 through 6 decimal numbers 
from 1 through 999999. 

WARNING or W 

If the maximum is exceeded, requests that JES3 issue an operator warning message 
and continue processing. 

Any messages about this parameter following the warning message will reflect the 
number specified on the STANDARD initialization statement or the system default, 
not the specified maximum. 

CANCEL or C 

If the maximum is exceeded, requests that JESS cancel the job. 

DUMP or D 

If the maximum is exceeded, requests that JES3 cancel the job and ask for a storage 
dump. 
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CARDS = ([nniiiil[,WARNINGl) 
CARDS = annniil[, WD 
CARDS = (InnnnI[,CANCELJ) 
CARDS = ([nnniil[,Cl) 
CARDS = ([nnnnU,DUMPl) 

CARDS = ([nnnnJ[,Dl) 

Specifies the maximum number of cards to be punched from this job's sysout data sets 
and the action to be taken if the maximum is exceeded. 

If you specify CARDS = the zero applies only to the quantity of punched output; it 
does not cancel the action to be taken if the maximum is exceeded. If a record is then 
sent to a punch, JES3 will warn, cancel, or dump, depending on the second parameter. 

Note: When punching dump output, JES3 ignores CARDS = 0. 

If CARDS is not specified, the installation default for this job class is used. 

nnnn 

Specifies the number of cards in hundreds, nnnn is 1 through 4 decimal numbers 
from 1 through 9999. 

WARNING or W 

If the maximum is exceeded, requests that JES3 issue an operator warning message 
and continue processing. 

Any subsequent messages about this parameter will reflect the number specified on 
the STANDARD initialization statement or the system default, not the maximum 
specified in the CARDS parameter. 

CANCEL or C 

If the maximum is exceeded, requests that JESS cancel the job. 

DUMP or D 

If the maximum is exceeded, requests that JES3 cancel the job and ask for a storage 
dxmip. 

CLASS = class-name 

Specifies the job class for this job. class-name is 1 through 8 characters. 

If the desired class-name is a single-character, you can specify it on the //*MAIN 
statement or the JOB statement. 

JES3 uses the following, in override order, to assign the job to a class: 

1. //*MAIN statement CLASS parameter 

2. JOB statement CLASS parameter 

3. The default class, which is defined during JES3 initialization. 

If neither CLASS nor LREGION is specified, JES3 determines the logical region size 
based on initiahzation parameters. 
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DEADLINE = (time,type[,datel) 
DEADLINE = (time,type[,rel,cyclel) 

Specifies when the job is required. 

If you specify the current date but submit the job after the specified time, JES3 changes 
the priorities to make the job the same priority level it would have been had it been 
submitted before the deadline but not completed. 

Warning: Deadline scheduling can interfere with dumping a portion of the job queue. 
For example, if JOB A is waiting to be scheduled, has a priority of 7, and, in one minute, 
is due to have its priority increased to 9, JOB A could be missed by dump job processing, 
if the dump job facility is dumping the entire job queue and currently dumping priority 8 
jobs. The dump job facility processes the jobs with the highest priority first. If the dump 
job facihty does not finish processing priority 8 jobs before JOB A becomes priority 9, 
JOB A will not be dumped. 

Deadhne scheduling information is not sent with a job when the job is transferred via 
NJE to another node; the destination node may use different deadline scheduhng 
algorithms, if any. 

time 

Specifies the deadUne time, expressed as one of the following: 



nM 



nH 



hhhh 



The job is to be scheduled within n minutes, n is 1 through 4 numbers from 
through 1440. 



The job is to be scheduled within n hours, n is 1 or 2 numbers from 
through 24. 



The job is to be scheduled by the time of day, hhhh, in 24-hour clock time 
(0800 is 8:00 a.m.). hhhh is from 0000 through 2400. 

type 

Identifies the deadline algorithm. The deadline algorithm is defined by the 
installation, controls how the job's priority is increased, and is one character: A 
through Z or through 9. If the specified algorithm is not defined, JES3 
abnormally terminates the job. 

date 

Specifies the date when the time parameter takes effect. The date is in the format 
mmddyy, where mm is the month (01-12), dd the day (01-31), and yy the year 
(00-99). 

If both date and rel,cycle are omitted, JES3 assumes (1) the current date, if the 
deadline time is later in the day, or (2) the next day's date, if the deadline time has 
already past today. 
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rel 

Specifies on which day within a cycle the deadline falls, rel is i through 3 numbers 
from 1 through 366. The vahie of rel depends on the specified cycle, as follov/s: 

9 WEEKLY: Sunday is day 1; Saturday is day 7. If rel is greater than 7, it 
defaults to 7. 

• MONTHLY: Day 1 is the first day of the month. Days 29, 30, and 31 are 
treated as the last day of the month. If rel is greater than 3 1 , it defaults to 3 1 . 

• YEARLY: Day 1 in January 1; day 365 is December 31, for regular years, and 
day 366 is December 31, for leap years. If rel is greater than 365, it defaults to 
365 for regular years or 366 for leap years. 

cycle 

Specifies the length of a cycle, cycle is coded as WEEKLY, MONTHLY, or 
YEARLY. 

For example, DEADLINE = (1200,B,1, WEEKLY) indicates that the job reaches its 
deadline at 12 noon every Sunday. 

EXPDTCHK = YES 

EXPDTCHK = NO 

Indicates whether or not JES3 is to perform expiration date checking for scratch output 
tape volumes with IBM standard labels (SL), 

YES 

Requests expiration date checking. Tape volumes premounted for SL scratch 
requests must have expired dates. 

NO 

Requests that expiration dates not be checked. 

FAILURE = RESTART 
FAILURE = CANCEL 
FAILURE = HOLD 
FAILURE = PRINT 

Indicates the job recovery option to be used if the system fails. If you do not code a 
FAILURE parameter on the //*MAIN statement, JES3 assigns the job the default failure 
option, which is defined during JES3 initialization for each job class. 

RES r ART 

Requests that JES3 restart the job when the failing processor is restarted. Do not 
specify RESTART for jobs that use the DEQ at DEMOUNT facility for tape 
volumes, 

CANCEL 

Requests that JES3 cancel the job for printing. 

HOLD 

Requests that JES3 hold the job for restart. 

PRINT 

Requests that JES3 print the job and then hold the job for restart. 
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FETCH = ALL 

FETCH = NONE 

FETCH = SETUP 

FETCH = (ddnamel,ddnamel...) 

FETCH = /(ddnamel,ddnamel...) 

Determines the fetch messages that will be issued to the operator for disk and tape 

volumes for this job. 

If FETCH is not specified, the installation default for this job class applies. 

ALL 

Requests that JES3 issue fetch messages to the operator for all removable volumes 
specified in DD statements that request JES3-setup devices. This subparameter does 
not apply to permanently resident volumes. 

NONE 

Requests that JES3 not issue fetch messages. 

SETUP 

Requests that JES3 issue fetch messages to the operator for the volumes specified in 
all DD statements identified in the //*MAIN SETUP parameter. If you code 
FETCH = SETUP without also coding the //*MAIN SETUP parameter, JES3 will 
issue fetch message as though you had specified FETCH = ALL. 

ddname 

Requests that JES3 issue fetch messages for only the volumes specified in DD 
statement ddname. 

If you code a list of ddnames and the Hst cannot be contained on a single statement, 
FETCH = must be repeated on the continuation statement. 

/ddname 

Requests that JES3 not issue fetch messages for any volumes specified in DD 
statement ddname. 

HOLD = YES 
HOLD = NO 



YES 

Indicates that the job is to enter the system in operator-hold status and be withheld 
from processing until the operator requests its release. However, if an error occurs 
during input service processing, the job is not held for operator intervention. 

This parameter has the same function as TYPRUN = HOLD on the JOB statement. 

NO 

Indicates that the job is to enter the system normally. Processing does not require 
operator intervention. If the HOLD parameter is omitted, NO is the default. 
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IORATE = MED 
IORATE = HIGH 
IORATE = LOW 

Indicates the I/O-to-processor ratio for a job. Use this parameter to balance the mixture 
of jobs selected for execution on the processor. 

If you do not code an lORATE parameter on the //*MAIN statement, JES3 assigns the 
job the default I/O-to-processor ratio, which is defined during JES3 initialization for each 
job class. 

JOURNAL = YES 

JOURNAL = NO 

Indicates whether or not JES3 is to create a job journal for the job. 

If JOURNAL is omitted, JES3 uses an installation default specified at initialization. 

YES 

Indicates that the job is to have a job journal. 

NO 

Indicates that the job is not to have a job journal. 

LINES = (fnniinl[,WARNLNG|) 
LINES = ([niiniil[,Wl) 
LINES = (|nnnnH,CANCEL) 
LINES = ((nnnn][,C]) 
LINES = ([iinnnl[,DUMP|) 
LINES = (InnnnI[,Dl) 

Indicates the maximum number of lines of data to be printed from this job's sysout data 

sets and the action to be taken if the maximum is exceeded. 

If you specify LINES = the zero applies only to the number of lines; it does not cancel 
the action to be taken if the maximum is exceeded. If a record is sent to be printed, JES3 
will warn, cancel, or dump, depending on the second parameter. 

Note: JES3 ignores any line count specification when printing the output for a 
SYSABEND or SYSUDUMP sysout data set. 

If LINES is not specified, the installation default for this job class applies. 

nnnn 

Specifies the number of lines, in thousands, nnnn is 1 through 4 decimal numbers 
from i through 9999. 

WARNING or W 

If the maximum is exceeded, requests that JES3 issue an operator warning and 
continue processing. 

Any messages about this parameter following the warning message will reflect the 
number specified on the STANDARD initialization statement or the system default, 
not me maximum specified m the LINES parameter. 
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CANCEL or C 

If the maximum is exceeded, requests that JES3 cancel the job. 

DUMP or D 

If the maximum is exceeded, requests that JES3 cancel the job and ask for a storage 
dump. 



LREGION = iinnnK 

Specifies the approximate size of the largest step's working set in real storage during 
execution, LREGION (logical region) is used by JES3 to improve scheduling on the 
processor. The nnnn is 1 through 4 decimal numbers that indicate the size in kilobytes (1 
kilobyte = 1024 bytes). 

If neither CLASS nor LREGION is coded, JES3 determines the logical region size based 
on initialization parameters. 

Use the LREGION parameter carefully. If the values selected for LREGION are too 
small, the job may take longer to run. 

MSS = JOB 
MSS = HWS 

Indicates that the job uses mass storage system (MSS) and specifies how JES3 should 
allocate the MSS virtual units. This parameter overrides the installation default defined 
at JES3 initialization. 

JOB 

Specifies that each request for an MSS volume is to be assigned to a separate virtual 
unit, 

HWS 

Specifies that virtual units are to be reused in subsequent job steps in order to 
minimize the number of units needed for the job. 

Note: The MSS and SETUP parameters on the //*MAIN statement can specify different 
types of allocation. For example, MSS can specify JOB while SETUP can specify HWS. 

ORG = group-name 
ORG = nodename[.remote] 

Indicates that the job's sysout data sets are to be directed to the named group or network 
node. Otherwise, the job's sysout data sets are directed to the group of devices or node 
from which the job originated. 

group-name 

Specifies an origin group. 

nodename 

Specifies a network node, nodename is 1 through 8 characters. 

remote 

Specifies a remote work station or VM userid. remote is 1 through 8 characters and 
must be separated from the nodename by a period. 
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Overriding an ORG Parameter: If you do not want a particular data set in the job to go 
to the destination on the ORG parameter, change its destination in one of the following 
ways: 

• If the sysout data set is not scheduled to a held class, override the ORG parameter 
destination by referencing the DD statement for the data set in a //* FORMAT 
statement. Specify the desired destination in the //* FORMAT statement DEST 
parameter. 

• If the sysout data set is scheduled to a held class, override the ORG parameter 
destination by referencing an OUTPUT JCL statement on the sysout DD statement. 
Specify the desired destination in the OUTPUT JCL statement DEST parameter. 

PAGES = ([nnnnnnnnI(,WARNINGl) 
PAGES = ([nnnnnnnnll, WD 
PAGES = (InnnnnnnnI[,CANCELI) 
PAGES = ([nnnnnnnnlI,Cl) 
PAGES = ((nnnnnnnnlI,DUMPl) 
PAGES = ([nnnnnnnnl|,DI) 

Indicates the maximum number of pages to be printed for this job's sysout data sets and 

the action to be taken if the maximum is exceeded. 

If PAGES is not specified, the installation default for this job class applies. 

nnnnnnnn 

Specifies the number of pages, nnnnnnnn is 1 through 8 decimal numbers from I 
through 16777215. 

WARNING or W 

If the maximum is exceeded, requests that JES3 issue an operator warning message 
and continue processing. 

Any messages about this parameter following the warning message will reflect the 
number specified on the STANDARD initialization statement or the system default 
value, not the maximum specified in the PAGES parameter. 

CANCEL or C 

If the maximum is exceeded, requests that JES3 cancel the job. 

DUMP or D 

If the maximum is exceeded, requests that JES3 cancel the job and ask for a storage 
dump. 

PROC^ST 
PROC = xx 

Names the procedure hbrary that the system is to search for cataloged procedures called 
by EXEC statements in the job. If a procedure cannot be found in the named library, 
JES3 abnormally terminates the job. 

If this parameter is omitted, the default depends on the source of the job. If the job is 
submitted as a batch job, the default is ST. If Ihc job is submitted from an internal 
reader, the default may be another procedure hbrary, as specified by the installation. 
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ST 



XX 



Indicates the standard procedure library: SYSl.PROCLIB. 



Identifies the last 2 characters of the ddname of a procedure library, xx is defined 
by the installation. If this parameter is coded, only the specified library is searched; 
SYS 1 .PROCLIB is not searched. 

RINGCHK = YES 
RINGCHK = NO 

Indicates whether or not JES3 is to check the status of the tape reel ring for tape devices 
set up by JES3. 



YES 



NO 



Indicates that a validation check is to be made. If the RINGCHK parameter is 
omitted, YES is the default. 



Indicates that ring checking is to be by-passed, for this job. 



SETUP = JOB 

SETUP = HWS 

SETUP = THWS 

SETUP = DHWS 

SETUP = (stepnaine.ddnaine[,stepname.ddnamel...) 

SETUP = ($tepiiame.procstepname.ddnaine|,stepnaine.procstepnaine.ddnainel...) 

SETUP = /(stepanine.ddname[,stepnaine.ddname|...) 

SETUP = /(stepanme.procstepnaine.ddnaine[,stepname.procstepname.ddnaine]...) 

Modifies the standard setup algorithm used in assigning devices to a job before its 

execution. 

If SETUP is omitted, JES3 assigns mountable tape and disk volumes based on an 
installation default defined at initialization. 

JOB 

Requests job setup, which is allocation of all JES3-managed devices required in the 
job before the job executes. JES3 mounts the initial volumes necessary to run all 
steps before the job executes. JOB overrides the SETUP parameter on the JES3 
STANDARDS initialization statement. 

HWS 

Requests high watermark setup, which is allocation of the minimum number of 
devices required to run the job. The minimum number is equal to the greatest 
number of devices of each type needed for any one job step. High watermark setup 
does not cause premounting of all mountable volumes. 

THWS 

Requests high watermark setup for tapes but job setup for disks. 

DHWS 

Requests high watermark setup for disks but job setup for tapes. 
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stepname.ddname 
stepname.procstepname.ddname 

Specifies explicit setup, which is allocation of the volumes needed for a DD 
statement before the job executes. JES3 premounts the indicated volumes. When 
requesting explicit setup, specify enough devices so that JES3 can allocate all the 
required devices at any one time. If too few devices are specified, JES3 cancels the 
job. 

Use form stepname.ddname to indicate DD statement, ddname, in step, stepname, in 
this job. Use form stepname.procstepname.ddname to indicate DD statement, 
ddname, in procedure step, procstepname, of a procedure that is called by a step, 
stepname, in this job. The ddname must match exactly the ddname on the DD 
statement. (See the example for the //*DATASET statement.) 

If you code a Hst of ddnames and the list cannot be contained on a single statement, 
SETUP = must be repeated on the continuation statement. 

/stepname.ddname 
/stepname.procstepname.ddname 

Requests that JES3 not explicitly set up any volumes specified in DD statement 
ddname. 

SPART = partition-name 

Indicates the spool partition in which JES3 is to allocate spool space to this job. 

partition-name 

Specifies the name of the spool partition, partition-name is 1 through 8 characters 
and must match a partition name specified during JES3 initialization. If the name 
does not match, JES3 ignores the SPART parameter and uses the installation 
default. 

The SPART parameter does not affect allocation for the sysout data sets for the job; 
these data sets always go to the spool partitions specified during JES3 initialization for 
the output classes. 

If SPART is not specified, JES3 allocates spool data sets to a partition, as follows, in 
override order: 

1. The spool partition for the job's class. 

2. The spool partition for the processor executing the job. 

3. The default spool partition. 

SYSTEM = ANY 

SYSTEM = JGLOBAL 

SYSTEM = JLOCAL 

SYSTEM = (main-namei,main-name]...) 

SYSTEM = /(main-name[,main-name]...) 

Indicates the processor that is to execute this job. If a specific processor is named, the 
processor name must also be specified on the CLASS initialization statement for the job 
class. 
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ANY 

Indicates any global or local system that satisfies the job's requirements. 

JGLOBAL 

Indicates that the job is to run on the global processor only. 

JLOCAL 

Indicates that the job is to run on a local processor only. 

main-name 

Indicates that the job is to run on the named processor or processors. 

/main-name 

Indicates that the job is not to run on the named processor or processors. 

Need for SYSTEM Parameter: If you omit a SYSTEM parameter, the job runs on the 
processor used for the job's class. Usually a SYSTEM parameter is not needed. 
However, if any DD statement UNIT parameter in the job specifies a device-number, a 
SYSTEM parameter must be coded. 



Parameter Agreements: The following parameters must be consistent with the SYSTEM 
parameter or JES3 will terminate the job: 

• CLASS parameter on the JOB or //*MAIN statement. The requested processor must 
be assigned to execute jobs in the specified class. 

• All devices specified on DD statement UNIT parameters must be available to the 
requested processor. 

• TYPE parameter on the //*MAIN statement must specify the system running on the 
requested processor. 

• Dynamic support programs requested on //*PROCESS statements must be able to be 
executed on the requested processor. 

TRKGRPS = (primary-qty,$econd-qty) 

Specifies the number of track groups to be assigned to the job. A track group is a 
number of spool space allocation units. The size of the track group is defined in the 
GRPSZ parameter on the JESS BUFFER or SPART initialization statement. 

primary-qty 

Specifies the number of track groups to be initially allocated. This quantity is one 
decimal number from I through 9. 

second-qty 

Specifies the number of track groups to be allocated when the currently allocated 
groups are filled and more space is needed. This quantity is one decimal mmiber 
from 1 through 9. 

The //*MAIN TRKGRPS parameter overrides a TRKGRPS parameter on the CLASS or 
i MAINPROC initiaUzation statement. However, when a sysout DD statement specifies an 
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output class, the TRKGRPS parameter for that output class overrides the //*MAIN 
TRKGRPS parameter. 

TYPE = ANY 
TYPE = VS2 

Indicates the control program that is to execute this job. If you omit a TYPE parameter, 

the job runs under the control program used for the job's class. 

ANY 

Indicates that JES3 is to use any control program that satisfies the job's 
requirements. In present systems, JES3 schedules the job on MVS. 

VS2 

Indicates that JES3 is to schedule the job on MVS. 

UPDATE = (dsname[,dsiiamel...) 

Identifies the procedure library data set(s) that this job is to update. This parameter 
causes all jobs using the identified data set and any concatenated data sets to be held until 
the update is complete. 

dsname 

Specifies the data set name. The identified data set cannot be concatenated to 
another data set. 

USER = userid 

Identifies the job with the specified TSO user, even though the job was not submitted via 
TSO by that user. The job can be submitted through any input source, other than the 
internal reader, provided the installation does not force job naming conventions. USER 
allows: 

® The TSO userid, interacting with a global or local processor, to issue the TSO 

OUTPUT command to access sysout data sets from the job. If the job executes on 
one processor and the TSO userid is attached to another processor, the ACMAIN 
parameter must identify the processor for the TSO userid. 

• The TSO userid, interacting with any processor, to inquire about the status of the job 
or to cancel the job. 

userid 

Identifies a TSO user, userid is 1 through 7 alphanumeric or national characters. 
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Location in the JCL 



Place the //*MAIN statement for a job after the JOB statement and before the first EXEC 
statement. 

When you specify ORG on a //*MAIN statement, place the //*MAIN statement before all 
//*FORMAT statements that do not contain a DEST parameter. If JES3 does not process the 
ORG parameter before the //* FORMAT statements, JES3 uses the default destination for the 
//*FORMAT statements; their output is sent to the node where the job entered the system. 

When you specify ORG on a //*MAIN statement that is part of a remote job, place the 
//*MAIN statement immediately after the second JOB statement. 

Examples of the //*MAIN Statement 



//*MAIN SYSTEM=SY1 , LINES= ( 5 , C ) , SETUP=HWS , 
//*FAILURE=RESTART , DEADLINE= ( 0800 , A , 3 , WEEKLY ) 

The job executes on processor SYl. It is estimated to produce not more than 5000 lines of 
printed output; if the output exceeds 5000 lines, JES3 is to cancel the job. HWS specifies high 
watermark setup, so JES3 is to allocate the minimum number of devices required for this job. 
If the system fails, JES3 is to restart the job on the processor SYl. JES3 is to complete this job 
by 8 a.m. every Tuesday (Tuesday is day number 3) by adjusting the job's scheduling priority 
using the installation-defined A-type deadhne scheduUng parameters. 

//*MAIN ACMAIN=2,USER=GARYHIL 

If this statement appears in a job entered from any TSO userid on any processor in the 
complex, then the job's sysout data sets would go to TSO userid GARYHIL on processor 2. 
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//*NET Statement 



Purpose: Use the //*NET statement to define the dependencies between jobs in a dependent 
job control (DJC) network, JES3 sets up a network of dependent jobs and executes them in ■< 
specific order. 



Syntax: 



//*NET NETID j=name [ , parameter ] . . . 

[id j 


The parameters are: 




ABCMP 1 = 
AC ) 


NOKI 


3 

3 




KEEI 


1 


jABNORMis 

[ab 


^l)= D 
F 

[r 


> 




NORMAL 
NC 


F 

(r 




/ 


DEVPOOL-^ ( 


ANY [ , device-name ,n] . . . [ ,SDGxx] . . . ) 
NET 


DEVRELSE= 


- YES 
NO 






NETREL = 
NR 


(net id, jobname) 




NHOLD l=n 
HC j 


NRCMP = 
PC 


HOLD 
NOHO 
FLSH 






OPHOLD = 
OH 


NO 
YES 






RELEASE 
RL 


= ( j obname [ , j obname ] . . . ) 




RELSCHCI 
RS 


' =n 


The //*NET statement consists of the characters //* in columns 1 through 3, NET in 
columns 4 through 6, a blank in column 7, and parameters in columns 8 through 72. JES3 
ignores columns 73 through 80. 
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Parameter Definition 



NETID = name 

Specifies the name of the DJC network for this job. name is 1 through 8 characters; the 
first character must be alphabetic. 

All jobs put into the system with the same NETID name form a DJC network. To add a 
job to an existing DJC network, specify the NETID name for that job. 

ABCMP = NOKP 
ABCMP = KEEP 

Indicates what action JES3 is to take if the job abnormally terminates. 

NOKP 

Indicates that JES3 is to purge the DJC network if the job abnormally terminates 
and has not been resubmitted by the time the other jobs in the network have 
completed. JES3 purges the network unless successor jobs or subnetworks are 
missing. If the ABCMP parameter is omitted, NOKP is the default. 

KEEP 

Indicates that the DJC network is to be kept in the system until (1) the job is 
resubmitted and completes normally or (2) the operator forces the network from the 
system. Use KEEP to make sure that the network is not purged until the operator 
takes proper action. 

Note: If the job abnormally terminates, you can resubmit it to the DJC network, and the 
network will be retained until the job completes. 

ABNORMAL = D 

ABNORMAL = F 

ABNORMAL = R 

NORMAL =D 

NORMAL =F 

NORMAL = R 

Indicates the action JESS is to take for this job when any predecessor job completes 
execution normally or abnormally. If the ABNORMAL parameter is omitted, the default 
is R, and, if the NORMAL parameter is omitted, the default is D. 

D 

Requests that JES3 decrease this job's NHOLD count, which indicates the number 
of predecessors for this job. When the NHOLD count becomes zero, JES3 can 
schedule this job. 

F 

Requests that JES3 flush this job and its successor jobs from the system. JES3 
cancels the job, prints any output, and cancels all successor jobs presently in the 
system, regardless of their normal or abnormal specifications. However, JES3 
admits into the system all successor jobs that enter after the DJC network has been 
flushed. To flush those jobs, the operator must cancel the jobs or the network. 

R 

Requests that JES3 retain this job in the system and not decrease the NHOLD 
count. R suspends the job and its successor jobs from scheduUng until either the 
predecessor job is resubmitted or the operator decreases the NHOLD count. 
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DEVPOOL = (ANYl4evice-nanie,nl...[,SDGxxl...) 
DEVPOOL = (NETI,device-name,nl..J,SDGxxI...) 

Identifies devices to be dedicated to this DJC network. The system allocates these devices 
only to jobs in the network. The DEVPOOL parameter should be coded on the //*NET 
statement that establishes the network; it is ignored on other //*NET statements. 

ANY 

Indicates that jobs in the network can use any dedicated or undedicated device. 
JES3 tries to allocate from the dedicated pool before allocating any undedicated 
devices. 

NET 

Indicates that jobs can use only devices dedicated to the network. 

device-naine,n 

Identifies a dedicated device. Code as many device-names with numbers as will fit 
on one statement, device-name specifies (1) a device name defined to JES3 by the 
installation during initialization or (2) a device-type specified in the UNIT 
parameter of an lODEVICE system generation macro instruction. See Installation: 
System Generation for a hst of IBM device types, n is the number of named devices, 
n is a number from 1 through 32767. 

iSJ3CjiXX 

Identifies a mass storage system (MSS) staging drive group to be pooled (fenced) for 
the DJG network, xx is the staging drive group number. 

DEVRELSE = YES 
DEVRELSE^NO 

Indicates when devices dedicated to the DJC network are to be released. The 
DEVRELSE parameter can be coded in several jobs in the network, but must not be 
coded in the first job. If no network job containing DEVRELSE = YES completes, the 
system releases the devices when it purges the network. 

YES 

Requests that JES3 release all devices at the end of this job. Completion of any job 
that specified DEVRELSE = YES causes the devices dedicated to the network to be 
released. 



NO 



Requests that JES3 release all devices only when the last job in the network ends. 



NETREL = (netidjobname) 

Indicates that this job must be executed before the named job in another DJC network 
can be executed. The NETREL parameter can be specified only once for each job of a 
DJC network. 

netid 

Identifies the NETID for the successor job. 

jobname 

Names the JOB statement for the successor job. 
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NHOLD = n 

Indicates the number of predecessor job completions required before this job can be 
released for scheduling. The predecessor number can include jobs from another DJC 
network, n is a number from through 32767. 

When the predecessor number reaches 0, the job is scheduled for execution. The system 
reduces this number: 

• When each predecessor job completes execution. 

• By operator command. 

• When a program in a predecessor job issues an assembler DJC WTO macro. See 
Supervisor Services and Macro Instructions for details. 

If you specify NHOLD = or omit the NHOLD parameter, this job has no predecessor 
jobs. JES3 can schedule it for immediate execution. 

If the NHOLD count is incorrect, the following can occur: 

• If n is greater than the actual number of predecessor jobs, JES3 does not release this 
job for execution when all of its predecessor jobs complete execution. 

• If n is less than the actual number of predecessor jobs, JES3 prematurely releases the 
job for execution. 

NRCMP = HOLD 
NRCMP=NOHO 
NRCMP = FLSH 

Indicates that a network job that completed normally is being resubmitted and that JES3 
must erase all references to the job before the job reenters the network. 

HOLD 

Indicates that JES3 is to hold the job until it is released by the operator. 

NOHO 

Indicates that JES3 is to allow the job to be scheduled as system resources become 
available. 

FLSH 

Indicates that JES3 is to flush the job from the system. 

OPHOLD=NO 
OPHOLD=YES 



NO 

Indicates that the job is to be processed normally without operator intervention. If 
OPHOLD is omitted, NO is the default. 

YES 

Indicates that JES3 is to hold the job until it is released by the operator. 
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RELEASE = (jobname[jobname]...) 

Indicates that this job must be executed before th^? named job(s) in this DJC network can 
be executed. 



jobname 

Names the JOB statement for a successor job. You can specify from 1 through 50 
successor jobnames. 

RELEASE is the only parameter on the //*NET statement that can be split and continued 
on the next statement. To continue the RELEASE parameter, end the statement with the 
comma following a jobname and continue the next statement with the next jobname. The 
left parenthesis appears at the beginning of the jobname list and the right parenthesis 
appears at the end of the list. For example: 

//*NET NETID=EXP 1 , RELEASE= { J0B3 5 , J0B2 7Z , MY JOB , 
WRITJB, JOBABC) 

RELSCHCT = ii 

Controls early set up of a dependent job's resources. Set up begins when the NHOLD 
count becomes less than or equal to n. n is a number from I through 32767. 

If you specify RELSCHCT = or omit the RELSCHCT parameter, JES3 does not set up 
dependent jobs early. 

Note: Use this parameter carefully; RELSCHCT can tie up devices and data sets for 
long times. Do not specify the RELSCHCT parameter: 

• For a job that may have catalog dependencies. 

• For a job that contains one or more //*PROCESS statements. 

Location in the JCL 

Place the //*NET statement for a job after the JOB statement and before the first EXEC 
statement. Code only one //*NET statement for each job in a DJC network. 

The //*NET statement must precede any //*PROCESS statements. 
Examples of the //*NET Statement 

//*NET NETID=NETO 1 , NHOLD=0 , DEVPOOL= (,3330,2) 

This statement defines a DJC network named NETOl. The network contains no predecessor 
jobs. The DEVPOOL parameter, which must be coded in the first job in the network, requests 
that JES3 establish a device pool of two 3330s for network NETOl. 

//*NET NETID=N1 , RELEASE=B , NETREL= (N2 , B2 ) 

This statement adds a job to the DJC network named Nl. This job must be executed before 
job B, which is in Nl, and before job B2, which is in the DJC network named N2. 
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//*NETACCT Statement 



Purpose: Use the //*NETACCT statement to specify accounting information that JESS is to 
transmit with a job to another node in the network. 



Syntax: 



// 



'^NETACCT parameter [ , parameter] . . 



The parameters are: 



PNAME=programmer " s-name 

ACCT=number 

BLDG=address 

DEPT=dept 

ROOM=room 

USERID=userid 



The //*NETACCT statement consists of the characters //* in columns 1 through 3, 
NETACCT in columns 4 through 10, a blank in column 11, and parameters in columns 
9 through 72. JES3 ignores columns 73 through 80. 

Do not continue a //*NETACCT statement. If the parameters cannot fit on one 
statement, code more than one //*NETACCT statement. 

Enclose any parameter value that contains special characters, including embedded 
blanks, in apostrophes. 



Parameter Deflnition 



PNAME = programmer's-name 

Identifies the programmer, programmer's-name is 1 through 20 characters. 

ACCT = number 

Gives the network account number, number is 1 through 8 characters. 

BLDG = address 

Gives the programmer's building address, address is 1 through 8 characters. 

DEPT = dept 

Gives the programmer's department number, dept is 1 through 8 characters. 

ROOM = room 

Gives the programmer's room number, room is 1 through 8 characters. 

USERID = userid 

Gives the programmer's network userid. userid is 1 through 8 characters. 
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Defaults 



For any //*NETACCT parameter that is omitted, JES3 uses an installation default specified a 
JES3 initialization. 

Location in the JCL 

Place the //*NETACCT statement(s) for a job stream to be transmitted immediately after the 
first JOB statement and before any //*ROUTE XEQ statements. 

Example of the //*NETACCT Statement 



//*NETACCT PNAME=COLLINS , ACCT=D58D92 1 , USERID=NXT 
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//*OPERATOR Statement 



Purpose: Use the //* OPERATOR statement to issue a message to the operator. Columns 1 
through 80 are written on the operator console and in the job's hard-copy log when JES3 reads 
in the job. 

Syntax: 



//♦OPERATOR message 



The //*OPERATOR statement consists of the characters //* in columns 1 through 3, 
OPERATOR in columns 4 through 11, a blank in column 12, and the message for the 
operator in columns 13 through 80. 



Location in the JCL 

Place the //*OPERATOR statement anywhere after the JOB statement. 

Example of the //*OPERATOR Statement 



//♦OPERATOR CALL EXT. 55523 WHEN THIS JOB STARTS 
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//*PAUSE Statement 



Purpose: Use the //*PAUSE statement to halt an input reader temporarily. When you enter a 
//*PAUSE statement through an input reader, JES3 issues a message and waits for the operator 
to reply. To start the input reader, the system operator must issue a *START command or a 
remote work station with console level 15 must send a start message. 

The //*PAUSE statement is intended primarily for system checkout and test. Tt should be 
issued only by remote work stations. 




The //*PAUSE statement consists of the characters //* in columns I through 3, PAUSE in 
columns 4 through 8, blanks in columns 9 and 10, and, optionally, comments starting in any 
column beginning with 11. JESS ignores columns 73 through 80. 



Location in the JCL 

Place the //*PAUSE statement before the first JOB statement in an input stream. If it appears 
after the first JOB statement, JES3 ignores it. 

Example of the //*PAUSE Statement 



//*PAUSE THIS IS A TEST. 
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//*PROCESS Statement 



Purpose: Use the //*PROCESS statement to control how JES3 processes a job. A job that 
contains //*PROCESS statements receives only the JES3 processing specified on the 
//♦PROCESS statements plus certain required processing. 

Specifically, the //*PROCESS statement calls a dynamic support program (DSP) in the DSP 
dictionary. JES3 must be able to process the called DSP. 

Standard Jab Processing: JES3 uses a series of processing functions to process a job. Standard 
processing consists of only the standard scheduler functions: 

Converter/interpreter service 
Main service 
Output service 
Purge service 

Nonstandard Job Processing: A nonstandard job uses one or more special processing functions 
in place of or in addition to standard processing or skips one or more of the standard functions. 
Specify a nonstandard job by following the JOB statement with a JES3 //*PROCESS statement 
for each processing function. 

Use of Nonstandard Job Processing: Nonstandard job processing is useful in testing. For 
example, a //*PROCESS statement can make JES3 bypass program execution so that the job's 
JCL can be checked. Another //*PROCESS statement can make JES3 bypass output 
processing; then the operator can check by inquiry command whether the job reached 
execution. 

Syntax: 



//*PROCESS dsp 

[parameter [ , parameter] . . . ] 



The //*PROCESS statement consists of the characters //* in columns 1 through 3, PROCESS 
in columns 4 through 10, a blank in colimin 11, and the DSP name beginning in column 12. 
The rest of the columns must be blank. 

If the requested DSP requires parameters, code them on the following statement(s). The 
parameter statement consists of parameters in columns 1 through 72, separated by commas. 
Columns 73 through 80 must be blank. 



Parameter Definition 
dsp 



Identifies the DSP that JES3 is to use in processing the job. Figure 21-1 lists the vahd 
DSP names and whether parameters can follow. 
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DSP 


DSP Function 


Parameters 


Standard processing functions: } 


CI 


JES3 Converter/Interpreter Service, which 
interprets the JCL and creates control blocks. 


Yes (See JESS Diagnosis) 


MAIN 


Main Service, which processes the program. 


No 


OUTSERV 


Output Service, which processes the job's output. 


No 


PURGE 


Purge Service, which purges the job. This is 
the last function in any job. JES3 automatically 
creates this DSP. 


No 


Nonstandard 


processing functions: 




CBPRNT 


Control Block Print 


Yes (See JESS Diagnosis) 


DISPDJC 


Display Dependent Job Control 


Yes (See JESS Diagnosis) 


DISPLAY 


Display Job Queues 


Yes (See JESS Diagnosis) 


DJC 


Invoke Dependent Job Control Updating 

Note: A //*PROCESS DJC statement is required only 

when a //*PROCESS MAIN statement is not coded. 


No 


DR 


Disk Reader 


Yes (See JESS Commands) 


ISDRVR 


Input Service Driver (JES3 Control 
Statement Processing) 


Yes (Qualified ddname of input 
data set) 


JESNEWS 


Use JESNEWS Facility 


Yes (See JESS Commands) 


XXX 


User-written DSP 


(See SPL: JESS User Modifications and 
Macros) 



Figure 21-1. DSPs for JES3 //*PROCESS Statements 



Location in the JCL 



• Place all //*PROCESS statements for a job immediately after the JOB statement and before 
the first EXEC statement. If the job includes a //*NET statement, the //*NET statement 
must appear between the JOB statement and the first //*PROCESS statement. 

• The //*PROCESS statements can be separated only by their parameter statements. 

• JES3 processes the //*PROCESS statements in the order in which they appear in the input 
stream. 

• The first //*PROCESS statement must request an interpreter DSP if you want input service 
error messages, which indicate that a job is to be scheduled for interpreter processing before 
being purged. 
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Examples of the //*PROCESS Statement 



//EXAMl JOB 
//*PROCESS CI 
//♦PROCESS MAIN 
//♦PROCESS OUTSERV 
//SI EXEC PGM=ANY 



JCL statements 



This example shows how to submit a simple job via //*PROCESS statements. It is processed 
like a standard job. The four standard scheduler functions are used for the job: CI, MAIN, 
OUTSERV, and PURGE. Note that PURGE is not specified; JES3 automatically creates this 
DSP. 

//EXAM2 JOB 
//♦PROCESS CI 
//♦PROCESS MAIN 
//♦PROCESS OUTSERV 
//♦PROCESS PLOT 
//♦ENDPROCESS 
//SI EXEC PGM=ANY 
//DDl DD ... 

JCL Statements 



This example shows how to request a user-written DSP: PLOT. PLOT is to be executed after 
output service has completed. Note that PURGE is again not specified but is automatically 
created. 

//EXAM3 JOB 

//♦PROCESS OUTSERV 

//♦FORMAT PR,DDNAME=S1.DS1,C0PIES=5 

//♦DATASET DDNAME=S1.DS1 

data 



//♦ENDDATASET 
//SI EXEC PGM=ANY 
//DSl DD DSNAME=DATA1 



This example uses JES3 output service and the //*DATASET statement. Five copies of data set 
DSl are printed on any local printer. 
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//*ROUTE XEQ Statement 

Purpose: Use the //* ROUTE XEQ statement to send the following input stream to a network 
node where the job is then executed. JES3 stops transmitting input stream records when it finds 
one of the following: 

• The second JOB statement after the //* ROUTE XEQ statement. 

• The input stream runs out of card images. 

Syntax: 



//*ROUTE XEQ nodename[ .vmguestid] 



The //*ROUTE XEQ statement consists of the characters //* in columns 1 through 3, 
ROUTE in columns 4 through 8, a blank in column 9, and, starting in any column from 10 
through 72: XEQ, followed by at least one blank and then parameters. JES3 ignores 
columns 73 through 80. 

Do not imbed blanks in the nodename or vmguestid parameters. 



Parameter Definition 



nodename 

Indicates the node. The nodename identifies an MVS JES2 system, an MVS JES3 
(global) system, a VSE POWER node, or a VM system. 

If nodename specifies a local node: 

• The job executes locally if the job begins with a JOB statement. 

• The job is terminated if the job begins with an NJE statement. 

.vmguestid 

Identifies a guest system running in a virtual machine (VM), for example, an MVS system 
running under VM. 

Note: Do not specify a work station or terminal in this parameter. 



Location in the JCL 



• Place the //* ROUTE XEQ statement after a JOB statement that is valid for the submitting 
location and any //*NETACCT statements. 

• Place the //* ROUTE XEQ statement immediately before a JOB statement that is vaHd for 
the executing location. 
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JOB Statement after //*ROUTE XEQ 



An error in the //* ROUTE XEQ statement can cause the JOB statement following the 
//*ROUTE XEQ to be processed at the submitting node. To prevent this, code NJB instead of 
JOB on the second JOB statement; JES3 changes the NJB to JOB before transmitting the job. 

Note: TSO users must code NJB instead of JOB on the second JOB statement. 



Example of the //*ROUTE XEQ Statement 



//JOBNl 


JOB 


options . . . 


//*ROUTE 


XEQ 


2 


//J0BN2 


JOB 


options . . . 


//STEPl 


EXEC 


PGM=REPORTER 


//DDl 


DD 


SYS0UT=A,DEST=N1R33 


//DD2 


DD 


SYSOUT=A,DEST=N2R33 


//DD3 


DD 


SYSOUT=B , DEST=R3 3 


//DDIN 


DD 


* 



data 



/' 



In this example, JOB statement JOBNI is entered through the JES3 system at node 1. The 
//*ROUTE XEQ statement tells JES3 to send the following input stream to node 2. 
Transmission of the input stream is stopped by the /* delimiter statement. JOB statement 
J0BN2 and all following statements until the delimiter are read and executed by the system at 
node 2. 

The sysout data sets are sent to two work stations: 

• Sysout data set DDl is produced at work station 33 attached to node 1. 

• Sysout data set DD2 is produced at work station 33 attached to node 2. 

• Sysout data set DD3 is produced at work station 33 attached to node 2. Because no node 
is specified, the executing node is assumed. 



Node 1 



Node 2 



Work 
Station 33 



Work 
Station il) 
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/*SIGNOFF Statement 



Purpose: Use the /*SIGNOFF statement to tell JES3 to end a remote job stream processing 
session. At the completion of the current print and/or punch streams, JES3 disconnects the 
remote work station from the system. If JES3 is reading jobs from the station when the output 
completes, JES3 disconnects the station when the input is completed. 

Both systems network architecture (SNA) and binary synchronous communication (BSC) 
remote work stations use the /*SIGNOFF statement. 

References: For more information on the /*SIGNOFF command, see SPL: JESS Initialization 
and Tuning. 

Syntax: 



/*SIGNOFF 



The /*SIGNOFF statement consists of the characters /* in columns 1 and 2, SIGNOFF in 
columns 3 through 9, and blanks in columns 10 through 80. 

Note that, unhke other JES3 statements, this statement starts with only one slash. 



Location in the JCL 

The /* SIGNOFF statement can appear anywhere in a local input stream or an input stream 
from a SNA or BSC remote work station. 

Example of the /*SIGNOFF Statement 

/*SIGNOFF 

This statement requests that JESS terminate a remote job stream processing session. 
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/*SIGNON Statement 



Purpose: Use the /*SIGNON statement to tell JES3 to begin a remote job stream processing 
session. The /*SIGNON statement can override the remote identification number normally 
assigned to the remote work station. This statement is optional for all work stations except 
non-multi-leaving remote stations on a switched line. 

Systems network architecture (SNA) remote work stations must use the LOGON command 
instead of the /*SIGNON statement to notify JESS of a connection request. 



Syntax: 



/*SIGNON work-station-name {A| (blank)} (R| (blank)} passwdl passwd2 



The /*SIGNON statement consists of the following: 



Column 


Contents 


1-2 


/* 


3-8 


SIGNON 


9-15 


blanks 


16-20 


work-station-name, beginning in 16 


21 


blank 


22 


A or a blank 


23 


R or a blank 


24 


blank 


25-32 


password!, beginning in 25 


33-34 


blanks 


35-42 


password2, beginning in 35 


43-80 


blanks 



Note that, unlike other JES3 statements, this statement starts with only one slash. 



Parameter Definition 



work-station-name 

Specifies the name of the remote work station. The work-station-name is 1 through 5 
characters and must have been defined on a JES3 RJPTERM initialization statement. 



Indicates an automatic reader. A can be coded only when the work station is a 
programmable terminal. Leave this column blank if you do not want to specify an 
automatic reader. 

R 

Indicates that print or punch output can be suspended if the needed device is not ready. 
R can be coded only when the work station is a nonprogrammable terminal. Leave this 
column blank if you do not want to specify the R option. 

passwordl 

Specifies the password for the remote job processing (RJP) line, passwordl is 1 through 
characters and must have been defined on a JES3 RJPLINE initialization statement. 
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password! 

Specifies the password for the work station, password! is 1 through 8 characters and 
must have been defined on a JESS RJPTERM initiahzation statement. 

Location in the JCL 

Place the /*SIGNON statement at the start of an input stream to be transmitted from a remote 
work station. 

Example of the /*SIGNON Statement 



/*SIGNON QUIN A PSWDl PSWD2 

This statement requests that remote work station QUIN begin a remote job stream processing 
session. The value A in column 22 specifies an automatic reader for the programmable 
terminal. PSWDl, beginning in column 25, is the password assigned to a dial hne. PSWD2, 
beginning in column 35, is the password assigned to the remote work station. 
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Chapter 22. Reference Tables 



This chapter contains the following reference tables: 

• Mutually exclusive DD statement parameters. 

• Capacities of direct access devices. 

• Track capacities. 



Chapter 22. Reference Tables 22-1 



Tables 




Legend: At the intersection of tlie horizontal and vertical columns, the 
square is shaded if the parameters should not be coded together and 
white if they can be coded together on the same DD statement. 

For example, to see if DISP and SYSOUT can appear on the same DD 
statement, look down the column marked DISP and across the column 
marked SYSOUT. If the square is shaded; they should not appear 
together. 

As indicated by the table, a parameter cannot appear twice on the same 
DD statement. 

Figure 22-1. Table of Mutually Exclusive DD Parameters 
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Device 


Storage 
Medium 


Cylinders 


Tracks 
Per Cylinder 


Bytes 
Per Track 


Bytes 
Per Cylinder 


Bytes 
Per Device 
(in millions) 


2305 
Model 2 


Disk 


96 


8 


14,660 


117,280 


11.3 


3330 


Disk 


404 


19 


13,030 


247,570 


100 


3330 Mod 11 


Disk 


808 


19 


13,030 


247,570 


200 


3340/3344 


Disk 


696 (70-megabytes) 
348 (35-megabytes) 


12 


8,368 


100,416 


69.8 (70-megabytes) 

34.9 (35-megabytes) 


3350 


Disk 


555 


30 


19,069 


572,070 


317.5 


3375 


Disk 


959 


12 


35,616 


427,392 


409.8 


3380 


Disk 


885 


15 


47,476 


712,140 


630.2 


Note: 3344 pertains only to the 70-megabyte 3340 



Figure 22-2. Direct Access Capacities 
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Physical 
Records 

per Track 


Maximam Bytes per Record Formatted without Keys 


2305-2 


3330/ 
3330 

Mod II 


3340/ 
3344 


3350 


3375 


3380^ 


J 

2 
3 
4 
5 


14660 
7231 
4754 
3516 

2773 


13030 

6447 

4253 

3156 

2498 


8368 
4100 
2678 
1966 
1540 


19069 

9442 

6233 

4628 

3665 


35616' 

17600 

11616 

8608 

6816 


47476' 
23476 
15476 
11476 
9076 


6 
7 
8 
9 
10 


2278 
1924 
1659 
1452 
1287 


2059 
1745 
1510 
1327 
1181 


1255 

1052 

899 

781 

686 


3024 
2565 
2221 
1954 
1740 


5600 
4736 
4096 
3616 
3200 


7476 
6356 
5492 
4820 
4276 


11 
12 
13 
14 
15 


1152 
1040 
944 
863 

792 


1061 
962 

877 
805 
742 


608 
544 
489 
442 
402 


1565 
1419 
1296 
1190 
1098 


2880 
2592 
2368 
2176 
2016 


3860 
3476 
3188 
2932 
2676 


16 
17 
18 
19 
20 


730 
676 

627 
584 
544 


687 
639 
596 

557 
523 


366 

335 
307 
282 
259 


1018 

947 

884 

828 

777 


1856 
1728 
1600 
1504 
1408 


2484 
2324 
2164 
2004 
1876 


21 

22 
23 
24 

25 


509 
477 
448 
421 
396 


491 
463 
437 
413 
391 


239 
220 
204 
188 

174 


731 
690 
652 
617 
585 


1312 
1248 
1152 
1088 
1056 


1780 
1684 
1588 
1492 
1396 


26 
27 
28 
29 
30 


373 
352 
332 
314 
297 


371 
352 
335 
318 
303 


161 
149 

137 
127 
117 


555 
528 
502 
478 
456 


992 
928 
896 
832 
800 


1332 
1268 
1204 
1140 
1076 


^ Standard access methods support records up to 32K data length; only EXCP supports records greater 
than 32K data length. 

^ For the 3380, the value is the data length. To obtain the value, the length is rounded up to a multiple 
of 32, then 12 bytes are subtracted. 
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Tables 



Physical 
Records 
per Track 


Maximum Bytes per Record Formatted with Keys 


2305-2 


3330/ 
3330 

Mod II 


3340/ 
3344 


3350 


33752 


3380^ 


1 

2 
3 
4 

5 


14569 

7140 

4663 

3425 
2682 


12974 
6391 

4197 
3100 

2442 


8293 
4025 
2603 
1891 
1465 


18987 

9360 

6151 

4546 

3583 


35456' 

17440 

11456 

8448 

6656 


47240' 
23240 
15240 
11240 
8840 


6 
7 
8 
9 
10 


2187 
1833 
1568 
1361 
1196 


2003 
1689 
1454 
1271 
1125 


1180 

977 

824 

706 

611 


2942 
2483 
2139 
1872 
1658 


5440 
4576 
3936 
3456 
3040 


7240 
6120 
5256 
4584 
4040 


11 

12 
13 
14 
15 


1061 
949 

853 
772 
701 


1005 
906 

821 
749 
686 


533 
469 
414 
367 

327 


1483 
1337 
1214 
1108 
1016 


2720 
2432 
2208 
2016 
1856 


3624 
3240 
2952 
2696 
2440 


16 

17 
18 
19 
20 


639 

585 
536 
493 

453 


631 
583 
540 
501 
467 


291 
260 

232 
202 
184 


936 
865 
802 

746 
695 


1696 
1568 
1440 
1344 
1248 


2248 
2088 
1928 
1768 
1640 


21 

22 
23 
24 

25 


418 
386 
357 
330 
305 


435 
407 
381 

357 
335 


164 
145 
129 
113 
99 


649 
608 
570 

535 
503 


1152 

1088 

992 

928 

896 


1544 
1448 
1352 
1256 
1160 


26 
27 
28 
29 
30 


282 
261 
241 
223 
206 


315 
296 

279 
262 
247 


86 

74 
62 

52 
42 


473 
446 
420 
396 
374 


832 
768 
736 
672 
640 


1096 

1032 

968 

904 

804 


^ Standard access methods support records up to 32K data length; only EXCP supports records greater 
than 32K data length. 

^ For the 3380, the value is the key length plus a data length. To obtain the value, both lengths are 
rounded up to multiples of 32, then 24 bytes are subtracted. 
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Index 



Index 



(apostrophe) 
use of to enclose special characters 4-5 
use of with special characters 4-5 
when not needed to enclose special characters 



.period, (double period) 

in syntax 4-3 
. (period) 

in syntax 4-2 
... (ellipsis) 

in syntax 4-3 



4-5 



() 



(parentheses) 
in syntax 4-2 



(logical or) 
in syntax 



4-2 



& 



& (ampersand) 

in syntax 4-2 
«&&dsname 

subparameter of DD DSNAME parameter 10-80 



{ 

{ } (braces) 

in syntax 4-2 



(asterisk) 
as code parameter of JES2 /*OUTPUT 

statement 20-15 
DD statement parameter 10-12 

defaults 10-12 

examples 10-13 

location in JCL 10-13 

relationship to other control statements 

relationship to other parameters 10-12 

unread records 10-13 



10-13 



description 10-12 

in syntax 4-2 

relationship to DD DATA parameter 10-35 

subparameter of /* JOBPARM SYSAFF 
parameter 20-7 

subparameter of DD S YSOUT parameter 10-131 

subparameter of JOB RESTART parameter 15-34 

subparameter of OUTPUT JCL CLASS 
parameter 17-17 
*.ddname 

description 10-57 

explained 4-6 

subparameter of DD DCB parameter 10-39 

subparameter of DD DSNAME parameter 10-80 

subparameter of VOLUME = REF 
subparameter 10-150 
Mabel 

in DD CNTL parameter 10-29 
*.name 

explained 4-6 

subparameter of DD OUTPUT parameter 10-1 13 
* .procstepname .ddname 

explained 4-6 

subparameter of VOLUME = REF 
subparameter 10-150 
*.stepname.ddname 

description 10-57 

subparameter of DD DCB parameter 10-39 

subparameter of DD DSNAME parameter 10-80 

subparameter of EXEC PGM parameter 14-22 

subparameter of VOLUME = REF 
subparameter 1 0- 1 50 
*.stepname.label 

in DD CNTL parameter 10-29 
*.stepname.name 

explained 4-6 

subparameter of DD OUTPUT parameter 10-113 
* . stepname .procstepname . ddname 

description 10-57 

explained 4-6 

subparameter of DD DCB parameter 10-39 

subparameter of DD DSNAME parameter 10-80 

subparameter of EXEC PGM parameter 14-22 

subparameter of VOLUME = REF 
subparameter 10-150 
*.stepname.procstepname.label 

in DD CNTL parameter 10-29 
*.stepname.procstepname.name 

explained 4-6 

subparameter of DD OUTPUT parameter 10-113 



[ 



[ ] (brackets) 
in syntax 4-2 
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/ 



/ (slash) 

subparameter of //*MAIN FETCH 

parameter 21-31 
subparameter of //*MAIN SETUP 

parameter 21-35 
subparameter of //*MAIN SYSTEM 
parameter 21-36 
/* (slash asterisk) 

as delimiter statement 12-1 
/*DEL 

statement for submitting jobs to internal 
reader 20-1, 21-1 
/*EOF 

statement for submitting jobs to internal 
reader 20-1, 21-1 
/*JOBPARM 

JES2 control statement 20-4 
description 20-4 
example 20-9 
location in JCL 20-8 
overrides 20-8 
parameters 20-5 
/♦MESSAGE 

JES2 control statement 20-10 
description 20-10 
example 20-10 
location in JCL 20-10 
relationship to /* ROUTE XEQ 
statement 20-10 
/*NETACCT 

JES2 control statement 20-11 
default 20-11 
description 20-11 
example 20-11 
location in JCL 20-11 
overrides 20-11 
parameter 20-11 
/*NOTIFY 

JES2 control statement 20-12 
description 20-12 
examples 20-13 
location in JCL 20-13 
overrides 20-12 
parameters 20-12 

relationship to other control statements 20-13 
/♦OUTPUT 

JES2 control statement 20-14 
description 20-14 
example 20-22 
location in JCL 20-22 
overrides 20-22 
parameters 20-15 

relationship to other control statements 20-22 
/♦PRIORITY 

JES2 control statement 20-23 
description 20-23 
example 20-24 
location in JCL 20-24 



overrides 20-23 

parameter 20-23 

relationship to other control statements 20-23 
/*PURGE 

statement for submitting jobs to internal 
reader 20-1 
/♦ROUTE 

/♦ROUTE PRINT 

description 20-25 
/* ROUTE PUNCH 

description 20-25 
/♦ROUTE XEQ 

description 20-25 

relationship to /♦MESSAGE statement 20-10 
JES2 control statement 20-25 

description 20-25 

examples 20-27 

location in JCL 20-27 

multiple statements 20-27 

parameters 20-25 

processing of 20-27 
/♦SCAN 

statement for submitting jobs to internal 
reader 20-1 
/♦SETUP 

JES2 control statement 20-28 

description 20-28 

example 20-28 

location in JCL 20-28 

parameters 20-28 
/♦SIGNOFF 

JES2 control statement 20-29 

description 20-29 

example 20-29 

location in JCL 20-29 
JES3 control statement 21-54 

description 21-54 

example 21-54 

location in JCL 21-54 
/♦SIGNON 

JES2 control statement 20-30 

description 20-30 

examples 20-3 1 

location in JCL 20-3 1 

parameters 20-30 
JES3 control statement 21-55 

description 21-55 

example 21-56 

location in JCL 21-56 

parameters 21-55 
/♦XEQ 

JES2 control statement 20-32 

description 20-32 

example 20-32 

location in JCL 20-32 

multiple statements 20-32 

parameters 20-32 
/♦XMIT 

JES2 control statement 20-33 

defaults 20-34 



X-2 MVS/XA JCL Reference 



Index 



description 20-33 

examples 20-35 

location in JCL 20-34 

parameter 20-33 
//*DATASET 

JES3 control statement 21-5 

description 2 1 -5 

examples 21-7 

location in JCL 21-6 

parameters 21-5 
//*ENDDATASET 

JES3 control statement 21-8 

description 21-8 

example 21-8 

location in JCL 21-8 
//*ENDPROCESS 

JES3 control statement 21-9 

description 21-9 

example 21-9 

location in JCL 21-9 
//♦FORMAT PR 

JES3 control statement 21-10 

description 21-10 

examples 21-19 

location in JCL 21-19 

parameters 21-11 

relationship to //*PROCESS statement 21-19 

relationship to sysout DD and OUTPUT JCL 
statements 21-19 
//♦FORMAT PU 

JES3 control statement 21-20 

description 21-20 

example 21-24 

location in JCL 21-24 

parameters 21-21 

relationship to //*PROCESS statement 21-24 

relationship to sysout DD and OUTPUT JCL 
statements 21-24 
//♦MAIN 

JES3 control statement 21-25 

description 21-25 

examples 21-39 

location in JCL 21-39 

parameters 21-27 
//♦NET 

JES3 control statement 21-40 

description 21-40 

examples 21-44 

location in JCL 21-44 

parameter 21-41 
//♦NETACCT 

JES3 control statement 21-45 

defaults 21-46 

description 21-45 

location in JCL 21-46 

parameters 21-45 
//♦OPERATOR 

JES3 control statement 21-47 

description 21-47 

example 21-47 



location in JCL 21-47 
//♦PAUSE 

JES3 control statement 21-48 
description 21-48 
example 21-48 
location in JCL 21-48 
//♦PROCESS 

end of 21-9 

JES3 control statement 21-49 
description 21-49 
examples 21-51 
location in JCL 21-50 
parameter 21-49 
//♦ROUTE XEQ 

JES3 control statement 21-52 
description 21-52 
example 21-53 
location in JCL 21-52 
parameters 21-52 



(comma) 
in syntax 4-2 

use of in parameter field 3-3 
when coded in brackets or braces 



4-3 



— (underscore) 

in syntax 4-3 



(equal sign) 
in syntax 4-2 



parameter of JES3 /♦SIGNON statement 21-55 
subparameter of DCB BFTEK subparameter 10-42 
subparameter of DCB OPTCD subparameter 10-48 
subparameter of DCB PCI subparameter 10-50 
subparameter of DCB RECFM 
subparameter 10-51, 10-52 

AB 

ABNORMAL parameter of JES3 //♦NET 
statement 21-40 

ABCMP 

parameter of JES3 //♦NET statement 21-41 

ABE 

subparameter of DCB EROPT subparameter 

ABNORMAL 

parameter of JES3 //♦NET statement 21-41 

abnormal termination 



10-45 
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See termination, abnormal 
ABSTR 

subparameter of DD SPACE parameter 10-124 
AC 

ABCMP parameter of JESS //*NET 
statement 21-40 
ACB (access method control block) 10-17 
ACC 

subparameter of DCB EROPT subparameter 10-45 
access method 

See also individual access methods 
for dummy data sets 10-83 
access method control block (ACB) 10-17 
access-code 

subparameter of DD ACCODE parameter 10-15 
ACCODE 

DD statement parameter 10-15 
defaults 10-15 
description 10-15 
example 10-16 
overrides 10-16 
subparameters 10-15 
account-number 

subparameter of JOB accounting information 
parameter 15-6 
accounting-information 

JOB statement parameter 1 5-5 
description 15-5 
examples 15-8 
JES2 format 15-6 

JES2 processing of invalid subparameters 1 5-7 
overrides of subparameters in JES2 

format 1 5-7 
relationship to other control statements 15-6 
subparameters 15-6 
subparameters for JES2 format 15-6 
specified on JESS //*NETACCT statement 21-45 
subparameter of EXEC ACCT parameter 14-6 
subparameter of JOB accounting information 
parameter 15-6 
ACCT 

EXEC statement parameter 14-5 
description 14-5 
examples 14-6 
subparameter 14-6 
parameter of JESS //*NETACCT statement 21-45 
ACMAIN 

parameter of JESS //*MAIN statement 21-27 
address 

subparameter of //*NETACCT BLDG 
parameter 21-45 
subparameter of DD SPACE parameter 10-124 
ADDRSPC 

EXEC statement parameter 14-7 
default 14-7 
description 14-7 
examples 14-8 
overrides 14-7 

relationship to REGION parameter 14-7 
subparameters 14-7 



JOB statement parameter 1 5-9 
default 15-9 
description 1 5-9 
examples 15-10 
overrides 1 5-9 

relationship to REGION parameter 15-9 
subparameters 1 5-9 
AFF 

subparameter of DD UNIT parameter 10-144 
affinity 

See unit affinity 
AL 

subparameter of DD LABEL parameter 10-99 
ALIGN 

subparameter of DD FCB parameter 10-87 
alignment, of printing forms 

specifying 10-87 
ALL 

subparameter of //*M AIN FETCH 

parameter 21-31 
subparameter of OUTPUT JCL JESDS 
parameter 1 7-42 
allocation, of data sets 

for MSS when MSVGP omitted 10-108 
holding for reuse 14-17 
allocation, of devices 
from groups 10-143 
number of 10-143 

when unit affinity is specified 10-144 
ALX 

subparameter of DD SPACE parameter 10-124 
AMORG 

subparameter of DD AMP parameter 10-18 
AMP 

DD statement parameter 10-17 
description 10-17 
examples 10-21 

relationship to other parameters 10-21 
subparameters 10-18 
with DSNAME parameter 10-81 
AN 

character set for 1403 10-140, 17-59 
character set for 3203 Model 5 10-140, 17-59 
ANY 

subparameter of /*JOBPARM SYSAFF 

parameter 20-7 
subparameter of //*MAIN SYSTEM 

parameter 21-36 
subparameter of //*MAIN TYPE parameter 21-38 
subparameter of //*NET DEVPOOL 
parameter 21-42 
ANYLOCAL 

subparameter of //*FORMAT DEST 

parameter 21-15, 21-22 
subparameter of DD DEST parameter 10-60 
subparameter of OUTPUT JCL DEST 
parameter 17-29 
area 

subparameter of DD DSNAME parameter 10-79, 
10-80 
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asterisk 

See * (asterisk) 
AUL 

subparameter of DD LABEL parameter 10-100 
All 

character set for 321 1 10-140, 17-59 



B 

subparameter of DCB OPTCD subparameter 10-49 

subparameter of DCB RECFM 
subparameter 10-51, 10-52, 10-53 
backward references 

See references 
base control program 

See BCP (base control program) 
basic direct access method 

See BDAM (basic direct access method) 
basic indexed sequential access method 

See BISAM (basic indexed sequential access 
method) 
basic partitioned access method 

See BPAM (basic partitioned access method) 
basic sequential access method 

See BSAM (basic sequential access method) 
basic telecommunications access method 

See BTAM (basic telecommunications access 
method) 
BCP (base control program) 

in relation to JCL statements 2-1 
BDAM (basic direct access method) 

subparameters of DD DCB parameter 10-42 
BFALN 

subparameter of DD DCB parameter 10-42 
BFTEK 

subparameter of DD DCB parameter 10-42 
BISAM (basic indexed sequential access method) 

subparameters of DD DCB parameter 10-42 
blanks 

use of in parameters 4-5 
BLDG 

parameter of JES3 //*NETACCT statement 21-45 
blklgth 

subparameter of DD SPACE parameter 10-122 
BLKSIZE 

coded with DATA parameter 10-36 

subparameter of DD DCB parameter 10-42 
block length 

specifying in the DD SPACE parameter 10-122 
block size 

See BLKSIZE 
blocks 

subparameter of DCB LIMCT subparameter 10-46 
BLP 

subparameter of DD LABEL parameter 10-100 
BPAM (basic partitioned access method) 

subparameters of DD DCB parameter 10-42 
BS 



subparameter of DCB RECFM 
subparameter 10-52 
BSAM (basic sequential access method) 

subparameters of DD DCB parameter 10-42 
with DD CHKPT parameter 10-27 
BST 

subparameter of DCB RECFM 
subparameter 10-52 
BT 

subparameter of DCB RECFM 
subparameter 10-51, 10-52 
BTAM (basic telecommunications access method) 
subparameters of DD DCB parameter 10-42 
buffer, forms control (F'CB) 

See FCB 
buffers 

requirements with DD AMP parameter 10-21 
subparameter of DCB BUFIN parameter 10-42 
subparameter of DCB BUFMAX 

subparameter 10-42 
subparameter of DCB BUFNO 

subparameter 10-43 
subparameter of DCB BUFOUT 
subparameter 10-43 
BUFIN 

subparameter of DD DCB parameter 10-42 
BUFL 

subparameter of DD DCB parameter 10-42 
BUFMAX 

subparameter of DD DCB parameter 10-42 
BUFND 

subparameter of DD AMP parameter 10-18 
BUFNI 

subparameter of DD AMP parameter 10-18 
BUFNO 

coded with DATA parameter 10-36 
subparameter of DD DCB parameter 10-43 
BUFOFF 

subparameter of DD DCB parameter 10-43 
BUFOUT 

subparameter of DD DCB parameter 10-43 
BUFSIZE 

subparameter of DD DCB parameter 10-43 
BUFSP 

subparameter of DD AMP parameter 10-18 
BURST 

DD statement parameter 10-22 
defaults 10-22 
description 10-22 
example 10-23 
overrides 10-22 

relationship to other control statements 10-23 
relationship to other parameters 10-23 
subparameters 10-22 
OUTPUT JCL statement parameter 17-9 
defaults 17-9 
description 17-9 
example 17-10 
overrides 17-9 
subparameters 17-9 
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parameter of JES2 /*JOBPARM statement 20-5 
parameter of JES2 /*OUTPUT statement 20- 1 6 
burster-trimmer-stacker 

See BURST 
BYTES 

parameter of JES2 /*JOBPARM statement 20-5 
parameter of JESS //*MAIN statement 21-27 
bytes 

per cylinder 22-3 

per direct access device 22-3 

per record with keys 22-5 

per record without keys 22-4 

per track 22-3 

subparameter of AMP BUFSP parameter 10-18 

subparameter of DCB BLKSIZE 

subparameter 10-42 
subparameter of DCB BUFL subparameter 10-42 
subparameter of DCB BUFSIZE 

subparameter 10-43 
subparameter of DCB KEYLEN 

subparameter 10-46 
subparameter of DCB LRECL subparameter 10-46 
subparameter of DCB RESERVE 

subparameter 10-53 



subparameter of //*DATASET DDNAME 

parameter 21-5 
subparameter of //*FORMAT STACKER 

parameter 21-18 
subparameter of //*MAIN BYTES 

parameter 21-27 
subparameter of //*MAIN CARDS 

parameter 21-28 
subparameter of //*MAIN LINES parameter 21-32 
subparameter of //*MAIN PAGES 

parameter 21-34 
subparameter of DCB MODE subparameter 10-47 
subparameter of DCB OPTCD 

subparameter 10-48, 10-49, 10-50 
subparameter of DCB TRTCH 

subparameter 10-54 
CANCEL 

subparameter of //*MAIN BYTES 

parameter 21-27 
subparameter of //*MAIN CARDS 

parameter 21-28 
subparameter of //*MAIN FAILURE 

parameter 21-30 
subparameter of //*MAIN LINES parameter 21-32 
subparameter of //*MAIN PAGES 

parameter 21-34 

of direct access devices 22-3 

parameter of JES2 /*JOBPARM statement 20-5 
parameter of JES3 //*MAIN statement 21-28 



cards 

JES2 format subparameter of JOB accounting 
information 15-7 
CARRIAGE 

parameter of JES3 //*FORMAT PR 
statement 21-12 
carriage control character 

specifying 17-21 
carriage-tape-name 

subparameter of //*FORMAT CARRIAGE 
parameter 21-12 
catalog 

private or user 

specifying for job 1 1 -2 
specifying for step 11-8 
cataloged procedures 

See procedures, cataloged and in-stream 
CATLG 

subparameter of DD DISP parameter 10-65, 10-66 
cccc 

subparameter of /*JOBPARM SYSAFF 
parameter 20-7 
character set 
chart of 4-4 
special character set 

specifying 10-140, 17-59 
use of in parameters 4-5 
use of in syntax 4-4 
using 10-141, 17-60 
universal character set (UCS) 

specification of 10-139, 17-58 
use of in statements 4-4 
character-arrangement table 

specifying on DD CHARS parameter 10-24 
specifying on OUTPUT JCL CHARS 
parameter 17-11 
character-set-code 

subparameter of DD UCS parameter 10-139 
subparameter of OUTPUT JCL UCS 
parameter 17-58 
CHARS 

affect of DD MODIFY parameter 10-105 
affect of OUTPUT JCL MODIFY 

parameter 17-47 
affect of OUTPUT JCL TRC parameter 1 7-56 
DD statement parameter 10-24 
defaults 10-25 
description 10-24 
examples 10-26 
overrides 10-25 
printer reassignment 10-26 
relationship to other control statements 10-26 
relationship to other parameters 10-25 
subparameters 10-24 
OUTPUT JCL statement parameter 17-11 
defaults 17-12 
description 17-11 
example 17-13 
overrides 17-12 
subparameters 17-11 
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parameter of JES2 /*OUTPUT statement 20-16 
parameter of JESS //*FORMAT PR 

statement 21-13 
checkid 

subparameter of JOB RESTART parameter 15-34 
checkpoint data set 

See data set, checkpoint 
checkpoints 

allowing and suppressing 14-25, 15-29 

logical page size for 17-14 

of data sets 11-20 

of programs 11-17 

restarting from 15-34 

written after specified number of logical 

pages 17-15 
written after specified number of seconds 17-16 
CHKPT 

DD statement parameter 10-27 
description 10-27 
examples 10-28 

for concatenated data sets 10-28 
overrides 10-27 

relationship to other parameters 10-27 
relationship to SYSCKEOV DD 

statement 10-27 
subparameter 10-27 
relationship to SYSCKEOV DD statement 11-20 
CHNSIZE 

parameter of JES3 //* FORMAT PR 

statement 21-13 
parameter of JES3 //*FORMAT PU 
statement 21-21 
CKPTLINE 

OUTPUT JCL statement parameter 17-14 
defaults 17-14 
description 17-14 
example 17-14 
CKPTLNS 

parameter of JES2 /*OUTPUT statement 20- 1 6 
CKPTPAGE 

OUTPUT JCL statement parameter 17-15 
defaults 17-15 
description 17-15 
example 17-15 

relationship to other parameters 17-15 
subparameter 17-15 
CKPTPGS 

parameter of JES2 /*OUTPUT statement 20-16 
CKPTSEC 

OUTPUT JCL statement parameter 17-16 
defaults 17-16 
description 17-16 
example 17-16 

relationship to other parameters 17-16 
subparameter 17-16 
CLASS 

JOB statement parameter 15-11 
defaults 15-11 
description 15-11 
example 15-12 



overrides 15-11 

relationship to other control statements 15-12 
subparameter 15-11 
OUTPUT JCL statement parameter 17-17 
description 17-17 
examples 17-19 
overrides 17-17 
subparameter s 17-17 
parameter of JES3 //*DATASET statement 21-6 
parameter of JES3 //*MAIN statement 21-28 
class 

subparameter of //*DATASET DDNAME 
parameter 21-6 
subparameter of DD S YSOUT parameter 10-131 
subparameter of JOB MSGCLASS 

parameter 15-17 
subparameter of OUTPUT JCL CLASS 
parameter 17-17 
class-name 

subparameter of //*MAIN CLASS 
parameter 21-28 
class, job 

assigning 15-11 
class, output 

assigning job log to 15-17 
held (in JES2 system) 

affect on JES2 /*JOBPARM COPIES 
parameter 20-6 
relationship to DD S YSOUT parameter 10-133 
relationship to OUTPUT JCL CLASS 
parameter 17-17 
significance of 10-134, 15-17, 17-18 
specifying on OUTPUT JCL statement 17-17 
specifying on sysout DD statement 10-130 
CLOSE 

macro instruction 

with DD SPACE parameter 10-123 
with the DD FREE parameter 10-94 
subparameter of DD FREE parameter 10-93 
CNTL 

DD statement parameter 10-29 
description 10-29 
examples 10-29 
subparameters 10-29 
JCL statement 9-1 
comments field 9-2 
description 9-1 
example 9-2 
label field 9-1 
location in JCL 9-2 
operation field 9-1 
parameter field 9-2 
CODE 
code 

parameter of JES2 /*OUTPUT statement 20- 1 5 
subparameter of EXEC COND parameter 14-10 
subparameter of JOB COND parameter 15-13 
code-name 

subparameter of DD SYSOUT parameter 10-132 
Command 
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JCL statement 7-1 

comments field 7-2 

description 7-1 

example 7-2 

location in JCL 7-2 

operation field 7-1 

parameter field 7-2 
JES2 statement 20-2 

description 20-2 

examples 20-3 

location in JCL 20-3 

operand 20-2 

parameters 20-2 
JES3 statement 21-3 

description 21-3 

examples 21-4 

location in JCL 21-4 

operand 21-3 

parameters 21-3 
command-verb 

parameter of JES2 command statement 20-2 
parameter of JES3 command statement 21-3 
Comment 

JCL statement 8-1 

description 8-1 

examples 8-1 

in listings 8-1 

location in JCL 8-1 
relationship to MSGLEVEL parameter 8-1 
COMPACT 

OUTPUT JCL statement parameter 17-20 

defaults 17-20 

description 17-20 

example 17-20 

overrides 17-20 

subparameter 17-20 
parameter of JES2 /*OUTPUT statement 20-16 
parameter of JES3 //*FORMAT PR 

statement 21-14 
parameter of JES3 //*FORMAT PU 
statement 21-22 
compaction table 

specifying 17-20 
compaction-table-name 

subparameter of //*FORMAT COMPACT 

parameter 21-14, 21-22 
subparameter of OUTPUT JCL COMPACT 
parameter 17-20 
concatenation, of data sets 
block sizes for 10-10 
checkpointing of 10-28 
coding concatenations 10-10 
description 10-10 
devices for 10-10 
of job catalogs 11-2 
of job libraries 11-5 
of step catalogs 11-8 
of step libraries 11-11 
references to 10-10 
with dummy data sets 10-10, 10-83 



COND 

affect on private job library specification 11-6 
EXEC statement parameter 14-9 

cautions 14-12 

description 14-9 

examples 14-14 

overrides 14-11 

subparameters 14-10 

summary charts 14-13 
JOB statement parameter 15-13 

description 15-13 

examples 15-14 

overrides 15-14 

subparameters 15-13 

summary chart 15-14 
CONTIG 

subparameter of DD SPACE parameter 10-124 
continuing, of statements 
examples 3-6 
of JCL statements 3-5 
of JES2 control statements 3-6 
of JES3 control statements 3-6 
CONTROL 

OUTPUT JCL statement parameter 17-21 

defaults 17-21 

description 17-21 

example 17-21 

subparameters 17-21 
parameter of JES3 //* FORMAT PR 
statement 21-14 
converter/interpreter service 
in job processing 21-49 
COPIES 

DD statement parameter 10-31 

defaults 10-32 

description 10-31 

examples 10-34 

overrides 10-32 

relationship to other control statements 10-33 

relationship to other parameters 10-32 

relationship to OUTPUT JCL COPIES 
parameter 10-33 

subparameters 10-31 
OUTPUT JCL statement parameter 17-22 

defaults 17-23 

description 17-22 

examples 17-24 

overrides 17-23 

relationship to other control statements 17-23 

relationship to other parameters 17-23 

subparameters 17-22 
parameter of JES2 /*JOBPARM statement 20-5 
parameter of JES2 /*OUTPUT statement 20-16 
parameter of JES3 //*FORMAT PR 

parameter of JES3 //*FORMAT PU 

statement 21-22 
relationship to DD FLASH parameter 10-91 
copies 
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JES2 format subparameter of JOB accounting 
information 1 5-7 
COPY 

subparameter of JOB TYPRUN parameter 1 5-40 
copy-modification module 

See modification, of printed output 
COPYG 

parameter of JES2 /*OUTPUT statement 20- 1 7 
copying job stream to sysout 

specifying 1 5-40 
count 

subparameter of /*OUTPUT FLASH 
parameter 20-19 

subparameter of /*OUTPUT FLASHC 
parameter 20-20 

subparameter of //*FORMAT FLASH 
parameter 21-16 

subparameter of DD FLASH parameter 10-90 

subparameter of OUTPUT JCL FLASH 
parameter 17-33 
CPRI 

subparameter of DD DCB parameter 10-43 
CROPS 

subparameter of DD AMP parameter 10-18 
CX 

subparameter of DCB DSORG 
subparameter 10-44 
cycle 

subparameter of //*MAIN DEADLINE 
parameter 21-29 
CYL 

subparameter of DD SPACE parameter 10-122 
cylinders 

number per device 22-3 

specifying in DD SPACE parameter 10-122 
CYLOFL 

subparameter of DD DCB parameter 10-44 



D 



D 



subparameter of //*MAIN BYTES 

parameter 21-27 
subparameter of //*MAIN CARDS 

parameter 21-28 
subparameter of //*MAIN LINES parameter 21-32 
subparameter of //*MAIN PAGES 

parameter 21-34 
subparameter of //*NET ABNORMAL 

parameter 21-41 
subparameter of //*NET NORMAL 

parameter 21-41 
subparameter of DCB BFALN subparameter 10-42 
subparameter of DCB BFTEK subparameter 10-42 
subparameter of DCB FUNC subparameter 10-45 
subparameter of DCB RECFM 

subparameter 10-52 



DA 



subparameter of DCB DSORG 
subparameter 10-44 
DATA 

DD statement parameter 10-35 

defaults 10-35 

examples 10-36 

location in JCL 10-36 

relationship to other control statements 10-36 

relationship to other parameters 10-35 

unread records 10-36 
description 10-35 
data control block 

See DCB 
data definition 

See DD 
data set 

See also sysout 
checkpoint 

for checkpointing data sets 11-20 

for checkpointing programs 11-17 
in generation group 

in restarted jobs 15-35 

labels for 10-99 

naming 10-79 
indexed sequential 

naming 10-79, 10-80 
multivolume 

referenced in VOLUME = REF 
subparameter 10-150 

specifying volume of 10-149 
partitioned (PDS) 

naming 10-79, 10-80 
passed 

unit count for 10-144 
permanent 

naming 10-79 
requesting resources for 2-2 
sequence number 

specifying in DD LABEL parameter 10-99 
system-managed 

sending to other destinations 17-43 

specifying processing of 17-42 
temporary 

naming 10-80 
data-set-sequence-number 

subparameter of DD LABEL parameter 10-99 
date 

subparameter of //*MAIN DEADLINE 
parameter 21-29 
DAU 

subparameter of DCB DSORG 
subparameter 10-44 
DCB 

copying attributes from 10-39 
data control block 

completing 10-40 

completing during execution 10-38 
DD statement parameter 10-38 

description 10-38 

examples 10-41 
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relationship to other parameters 10-40 

subparameters 10-39. 10-42 
macro instruction 10-38 
DD 

JCL statement 10-1 

comments field 10-9 

ddname. 10-1 

description 10-1 

examples 10-11 

location in JCL 10-10 

name field 10-1 

operation field 10-3 

parameter field 10-3 
maximum statements per job 10-1 
special DD statements 

description 11-1 
DDNAME 

on DD statement 10-55 

description 10-55 

examples 10-57 

location in JCL 10-55 

location of referenced statement 10-56 

overrides 10-55 

parameters not permitted on referenced DD 
statement 10-36 

referenced DD statement 10-56 

relationship to other parameters 10-55 

subparameter 10-55 
parameter of JES3 //*DATASET statement 21-5 
parameter of JES3 //* FORMAT PR 

statement 21-12 
parameter of JES3 //*FORMAT PU 
statement 21-21 
ddname 

examples 10-11 

invalid with DD AMP parameter 10-21 
name field on DD statement 10-1 
reserved for special uses 11-1 
special ddnames 10-2 
subparameter of /*JOBPARM PROCLIB 
parameter 20-6 
subparameter of //*MAIN FETCH 

parameter 21-31 
subparameter of DD DDNAME parameter 10-55 
subparameter of DD MSVGP parameter 10-107 
DEADLINE 

parameter of JES3 //*MAIN statement 21-29 
DEFAULT 

OUTPUT JCL statement parameter 17-25 

defaults 17-25 

description 17-25 

example 17-26 

location in JCL 17-25 

references to default OUTPUT JCL 
statements 17-26 

subparameters 17-25 
default 

location of default OUTPUT JCL statements 17-6 
OUTPUT JCL statement 17-5 
specifying statements 17-25 



DEFER 

subparameter of DD UNIT parameter 10-144 

M~^ mZi JL/ A-j J mZ> 

subparameter of DD DISP parameter 10-65 
delimiter 

for JES3 in-stream data sets 21-8 
processing when invalid 10-74 
subparameter of DD DLM parameter 10-73 
with DD * statement 10-12 
with DD DATA statement 10-35 
delimiter statement 

JCL statement 12-1 
comments field 12-1 
description 12-1 
examples 1 2-2 
location in JCL 12-1 
relationship to DLM parameter 12-1 
DEN 

subparameter of DD DCB parameter 1 0-44 
density, magnetic 

specifying for tape data set 10-44 
DEPT 

parameter of JES3 //*NETACCT statement 21 -45 
dept 

subparameter of //*NETACCT DEPT 
parameter 21-45 
DEST 

DD statement parameter 1 0-59 
defaults 10-61 
description 10-59 
examples 10-62 
overrides 10-61 

relationship to other control statements 10-62 
relationship to other parameters 10-61 
subparameters for JES2 10-59 
subparameters for JES3 1 0-60 
OUTPUT JCL statement parameter 17-28 
defaults 17-30 
description 17-28 
examples 17-30 
overrides 17-30 
subparameter for JES2 17-28 
subparameters for JES3 17-29 
parameter of JES2 /*OUTPUT statement 20-17 
parameter of JES3 //*FORMAT PR 

statement 21-15 
parameter of JES3 //*FORMAT PU 
statement 21-22 
destination, for data set 

specifying on OUTPUT JCL statement 10-59, 
17-28 
device-name 

See also name 

subparameter of //* FORMAT DEST 

parameter 21-15, 21-22 
subparameter of //*NET DEVPOOL 
parameter 21-42 
subparameter of DD DEST parameter 10-60 
subparameter of OUTPUT JCL DEST 
parameter 17-29 
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device-number 

subparameter of //*FORMAT DEST 

parameter 21-15, 21-23 
subparameter of DD DEST parameter 10-60 
subparameter of DD UNIT parameter 10-142 
device-type 

subparameter of DD UNIT parameter 10-142 
devices 

sharing through unit affinity 10-144 
specifying in DD UNIT parameter 10-142 
DEVPOOL 

parameter of JES3 //*NET statement 21-42 
DEVRELSE 

parameter of JESS //*NET statement 21-42 
DHWS 

subparameter of //*M AIN SETUP 
parameter 21-35 
DIAGNS 

subparameter of DD DCB parameter 10-44 
directory 

subparameter of DD SPACE parameter for system 
assignment 10-123 
discrete profile 

See RACE (resource access control facility) 
diskette input/output 

See 3540 diskette input/output unit 
DISP 

DD statement parameter 10-63 
defaults 10-66 
description 10-63 
examples 10-72 

relationship to other parameters 10-67 
subparameters 10-63 
dispatching priority 

See priority, dispatching 
disposition, of data sets 
at abnormal termination 

coded in DD DISP parameter 10-65 
at normal termination 

coded in DD DISP parameter 10-65 
DISP = MOD for multivolume data set 10-68 
of partitioned data sets 10-67 
of QS AM data sets 10-67 
of temporary data sets 10-67 
of VS AM data sets 10-67 
DLM 

DD statement parameter 10-73 
default 10-73 
description 10-73 
example 10-74 

relationship to other parameters 10-74 
subparameter 10-73 
parameter of JES2 /*XMIT statement 20-34 
DOUBLE 

subparameter of //* FORMAT CONTROL 

parameter 21-14 
subparameter of OUTPUT JCL CONTROL 
parameter 17-21 
DPRTY 

EXEC statement parameter 14-15 



defaults 14-16 

description 14-15 

examples 14-16 

relationship to other control statements 14-16 

subparameters 14-15 



DS 



subparameter of //* FORMAT CHNSIZE 
parameter 21-13, 21-21 
DSID 

DD statement parameter 10-75 
description 10-75 
example 10-76 

relationship to other parameters 10-76 
subparameters 10-75 
DSN 

See DSNAME 
DSNAME 

DD statement parameter 10-77 
description 10-77 
examples 10-81 

relationship to other parameters 10-80 
subparameter for dummy data set 10-80 
subparameters 10-78 

subparameters for permanent data set 10-78 
subparameters for temporary data set 10-79 
subparameters when copying data set 
name 10-80 
invalid with DD AMP parameter 10-21 
dsname 

subparameter of //*M AIN UPDATE 

parameter 21-38 
subparameter of DD DCB parameter 10-39 
subparameter of DD DSNAME parameter 10-79 
subparameter of VOLUME = REF 
subparameter 10-150 
DSORG 

subparameter of DD DCB parameter 10-44 
dsp 

parameter of JES3 //*PROCESS statement 21-49 
DSP (dynamic support program) 

calling of 21-49 
DUMMY 

DD statement parameter 10-82 
description 10-82 
examples 10-83 
parameters 10-82 

relationship to other control statements 10-83 
relationship to other parameters 10-83 
in concatenations 10-10 
referenced in VOLUME = REF 

subparameter 10-151 
same effect with NULLFILE 10-80 
DUMP 

subparameter of //*MAIN BYTES 

parameter 21-27 
subparameter of //*MAIN CARDS 

parameter 21-28 
subparameter of //*MAIN LINES parameter 21-32 
subparameter of //*MAIN PAGES 
parameter 21-34 
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subparameter on DD CHARS parameter 10-24 
subparameter on OUTPUT JCL CHARS 
parameter 17-12 
dumps 

duplicate requests for 11-15 

high-density 10-24, 10-88, 17-12, 17-32 

printing 11-14 

requesting on DD statement 10-26, 10-88 

requesting on OUTPUT JCL statement 17-13, 

17-32 
specifying by SYSABEND, SYSMDUMP, and 

SYSUDUMP DD statements 11-13 
storing 11-13 
DYNAM 

DD statement parameter 10-85 
description 10-85 
example 10-85 

relationship to other control statements 10-85 
relationship to other parameters 10-85 
dynamic support program 

See DSP (dynamic support program) 
DYNAMNBR 

EXEC statement parameter 14-17 
defaults 14-17 
description 14-17 
example 14-17 
subparameter 14-17 



specifying options for 10-45 



ET 



subparameter of //*DATASET DDNAME 
parameter 21-5 
subparameter of DCB BFTEK subparameter 10-42 
subparameter of DCB CPRI subparameter 10-43 
subparameter of DCB MODE subparameter 10-47 
subparameter of DCB OPTCD subparameter 10-48 
subparameter of DCB TRTCH 
subparameter 10-54 
END 

subparameter of DD FREE parameter 10-93 
ENDCNTL 

JCL Statement 13-1 
comments field 13-1 
description 13-1 
example 13-2 
label field 13-1 
location in JCL 13-1 
operation field 13-1 
EOV 

subparameter of DD CHKPT parameter 10-27 
EQ 

subparameter of EXEC COND parameter 14-10 
subparameter of JOB COND parameter 15-13 
EROPT 

subparameter of DD DCB parameter 10-45 
error 



subparameter of DCB TRTCH 
subparameter 10-54 
EVEN 

subparameter of EXEC COND parameter 14-11 
EXCP (execute channel program) 

subparameters of DD DCB parameter 10-42 

JCL statement 14-1 
comments field 14-4 
description 14-1 
examples 14-4 
location in JCL 14-4 
name field 14-1 
operation field 14-2 
parameter field 14-2 
execute channel program 

See EXCP (execute channel program) 
execute statement 

See EXEC 
execution 

bypassing of 14-9,15-13 
holding 15-40 

of job at network node 21-52 
restarting step 14-25, 15-29 
specifying program for 14-22 
timing 14-31, 15-37 
EXPDT 

subparameter of DD LABEL parameter 10-102 
EXPDTCHK 

parameter of JES3 //*MAIN statement 21-30 
expiration, of data set 
deleting before 10-102 
specifying in DD LABEL parameter 10-101 
extents 

allocation of 10-123 
external writer 

See writer, external 
EXTWTR 

parameter of JES3 //*FORMAT PR 

statement 21-15 
parameter of JES3 //*FORMAT PU 
statement 21-23 



in coding DD OUTPUT parameter 
in reading or writing a data set 



10-114 



subparameter of //*NET ABNORMAL 

parameter 21-41 
subparameter of //*NET NORMAL 

parameter 21-41 
subparameter of AMP RECFM 

subparameter 10-20 
subparameter of DCB BFALN subparameter 10-42 
subparameter of DCB OPTCD subparameter 10-48 
subparameter of DCB RECFM 

subparameter 10-51, 10-52, 10-53 
FAILURE 
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parameter of JESS //*MAIN statement 21-30 
FB 

subparameter of AMP RECFM 
subparameter 10-20 
FCB 

DD statement parameter 10-86 

defaults 10-87 

description 10-86 

examples 10-88 

overrides 10-87 

relationship to other control statements 10-88 

relationship to other parameters 10-87 

subparameters 10-86 
defining for work station 10-88 
OUTPUT JCL statement parameter 17-31 

defaults 17-32 

description 17-31 

example 17-32 

overrides 17-32 

subparameters 17-31 
parameter of JES2 /*OUTPUT statement 20-19 
parameter of JES3 //*FORMAT PR 
statement 21-16 
fcb-name 

.subparameter of OUTPUT JCL FCB 
parameter 17-31 
subparameter of DD FCB parameter 10-86 
FETCH 

parameter of JESS //*MAIN statement 21-31 
fields, in statements 
chart of 3-2 
comments 

format for 3-2 

rules for continuing 3-5 
continuing to following statements 3-5 
identifier 

format for 3-1 
location in statements 3-2 
name 

format for 3-1 
operation 

format for 3-1 
parameter 

detailed syntax for 3-3 

format for 3-2 

rules for continuing 3-5 
file definition statements 10-38 
FLASH 

DD statement parameter 10-90 

defaults 10-90 

description 10-90 

example 10-92 

overrides 10-91 

relationship to other control statements 10-91 

relationship to other parameters 10-91 

subparameters 10-90 
OUTPUT JCL statement parameter 17-33 

defaults 17-34 

description 17-33 

example 17-35 



overrides 17-34 

relationship to other parameters 17-34 
subparameters 17-33 
parameter of JES2 /*OUTPUT statement 20-19 
parameter of JESS //*FORMAT PR 
statement 21-16 
FLASHC 

parameter of JES2 /*OUTPUT statement 20-20 
flashing 

printing with 10-90, 17-33 
printing without 10-92, 17-34 
relationship to DD COPIES parameter 10-32 
relationship to OUTPUT JCL COPIES 
parameter 17-23 
FLSH 

subparameter of //*NET NRCMP parameter 21-43 
FOLD 

subparameter of DD UCS parameter 10-139 
form-name 

subparameter of //* FORMAT FORMS 

parameter 21-17, 21-23 
subparameter of DD SYSOUT parameter 10-132 
subparameter of OUTPUT JCL FORMS 
parameter 17-38 
format, of statements 

fields 3-1 
format, record 

See RECFM 
FORMDEF 

OUTPUT JCL statement parameter 17-36 
description 17-36 
example 17-37 
overrides 17-36 
subparameter 17-36 
FORMS 

OUTPUT JCL statement parameter 17-38 
defaults 17-38 
description 17-38 
example 17-38 
overrides 17-38 
subparameters 17-38 
parameter of JES2 /* JOBPARM statement 20-6 
parameter of JES2 /*OUTPUT statement 20-20 
parameter of JESS //*FORMAT PR 

statement 21-17 
parameter of JESS //* FORMAT PU 
statement 21-23 
forms 

for printing or punching 10-86, 17-31 

JES2 format subparameter of JOB accounting 

information 15-7 
specifying on OUTPUT JCL FORMS 

parameter 17-38 
specifying on sysout DD statement 10-130 
forms control buffer (FCB) 

See FCB 
forms overlay, printing with 

See flashing 
forward references 
See references 
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FREE 

affect on JES2 /*JOBPARM COPIES 

paraiiieter 20-6 
DD statement parameter 10-93 

defaults 10-93 

description 10-93 

examples 10-94 

overrides 10-93 

relationship to other control statements 10-94 

relationship to other parameters 10-93 

subparameters 10-93 
FUNC 

subparameter of DD DCB parameter 10-45 
with LABEL parameter 10-102 



G 



group, output 

specifying on the OUTPUT JCL statement 17-39 
GROUFID 

OUTPUT JCL statement parameter 17-39 
description 17-39 
examples 17-40 

relationship to other control statements 17-39 
subparameter 17-39 
GS 

subparameter of DCB DSORG 
subparameter 10-44 
GT 

subparameter of EXEC COND parameter 14-10 
subparameter of JOB COND parameter 15-13 
GU 

character set for 321 1 10-140, 17-59 



GAM (graphics access method) 

subparameters of DD DCB parameter 10-42 
GE 

subparameter of EXEC COND parameter 14-10 
subparameter of JOB COND parameter 15-13 
generalized trace facility 

See GFT (generalized trace facility) 
generation 

subparameter of DD DSNAME parameter 10-79 
GFT (generalized trace facility) 

use of 10-44 
GNCP 

subparameter of DD DCB parameter 10-45 
graphics access method 

See GAM (graphics access method) 
GROUP 

JOB statement parameter 15-15 
defaults 15-15 
description 15-15 
example 15-16 

relationship to other parameters 15-16 
subpar ameter 15-15 
group-name 

See also name 

subparameter of //* FORMAT DEST 
parameter 21-15, 21-23 
subparameter of //*MAIN ORG parameter 21-33 
subparameter of DD DEST parameter 10-60 
subparameter of DD UNIT parameter 10-143 
subparameter of JOB GROUP parameter 15-15 
subparameter of OUTPUT JCL DEST 
parameter 17-29 
group-value 

subparameter of /*OUTPUT COPIES 

parameter 20-16 
subparameter of /*OUTPUT COPYG 

parameter 20-17 
subparameter of //*FORMAT COPIES 

parameter 21-14 
subparameter of DD COPIES parameter 10-31 
subparameter of OUTPUT JCL COPIES 
parameter 17-22 



H 



H 

subparameter of DCB OPTCD 
subparameter 10-48, 10-49 
hard-copy log, job 

request to not print 20-6 
sending messages to, in JES3 system 21-47 
specifying processing of 1 7-42 
HC 

NHOLD parameter of JES3 //*NET 
statement 21-40 
held class 

See class, output, held (in JES2 system) 
HIGH 

subparameter of //*M AIN lORATE 
parameter 21-32 
high-density 

See dumps 
HN 

character set for 1403 and 3203 Model 5 10-140, 
17-59 
HOLD 

affect on JES2 /*JOBPARM COPIES 

parameter 20-6 
DD statement parameter 10-96 
defaults 10-96 
description 10-96 
example 10-97 
overrides 10-96 

relationship to other control statements 10-97 
relationship to other parameters 10-96 
subparameters 10-96 
parameter of JES3 //*MAIN statement 21-31 
subparameter of //*MAIN FAILURE 

parameter 21-30 
subparameter of //*NET NRCMP parameter 21-43 
subparameter of JOB TYPRUN parameter 15-40 
holding jobs 

specifying 15-40 
HWS 

subparameter of //*MAIN MSS parameter 21-33 
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subparameter of //*MAIN SETUP 
parameter 21-35 

character set for 321 1 10-140, 17-59 



I 

subparameter of AMP OPTCD 

subparameter 10-19 
subparameter of DCB FUNC subparameter 10-45 
subparameter of DCB OPTCD subparameter 10-50 
IBM standard labels 

See SL 
ID 

NETID parameter of JES3 //*NET 
statement 21-40 
id 

subparameter of DD DSID parameter 10-75 
subparameter of DD MSVGP parameter 10-107 
IL 

subparameter of AMP OPTCD 
subparameter 10-19 
image-name 

subparameter of //*FORMAT FCB 
parameter 21-16 
IN 

subparameter of DD LABEL parameter 10-101 
in-stream data 

for procedures 10-13 

multiple in-stream data sets in a step 10-13 
with DD * statement 10-12 
with DD DATA statement 10-36 
with JES3 //*DATASET statement 21-5 
in-stream procedures 

See procedures, cataloged and in-stream 
IND 

subparameter of /*JOBPARM SYSAFF 
parameter 20-7 
INDEX 

OUTPUT JCL statement parameter 17-41 
defaults 17-41 
description 17-41 
example 17-41 

relationship to other parameters 17-41 
subparameter 17-41 
parameter of JES2 /*OUTPUT statement 20-20 
index 

subparameter of DD SPACE parameter for specific 

requests 10-124 
subparameter of DD SPACE parameter for system 
assignment 10-123 
indexing of print margins 

specifying on OUTPUT JCL statement 17-41, 
17-44 
information 

subparameter of EXEC PARM parameter 14-18 
input stream 

definition 2-1 



halting reading of, in JES3 system 21-48 
INT 

parameter of JES3 //*FORMAT PU 
statement 21-23 
interactive problem control system 

See IPCS (interactive problem control system) 
internal reader 

See reader, internal 
INTRDR 

See also reader 

subparameter of OUTPUT JCL WRITER 
parameter 17-61 

writer-name subparameter on DD SYSOUT 
parameter 10-131 
INTVL 

subparameter of DD DCB parameter 10-45 
lORATE 

parameter of JES3 //*MAIN statement 21-32 
IPCS (interactive problem control system) 

to print dump 11-14 
IPLTXID 

subparameter of DD DCB parameter 10-45 
IS 

subparameter of DCB DSORG 
subparameter 10-44 
ISO/ANSI/FIPS Version 1 or 3 tape data set 

indicating in DD LABEL parameter 10-99, 10-100 

restriction on DD DISP parameter 10-64 

with DD ACCODE parameter 10-15 
ISU 

subparameter of DCB DSORG 
subparameter 10-44 



parameter of JES3 //*DATASET statement 21-6 
subparameter of DCB OPTCD subparameter 10-49 
JCL (job control language) 
statements 

format for 3-1 
introduced iii, 1-1 
subparameter of OUTPUT JCL JESDS 
parameter 17-42 
JCLHOLD 

subparameter of JOB TYPRUN parameter 1 5-40 
JCLTEST 

subparameter of EXEC PGM parameter 14-23 
JESDS 

location of statement containing 17-6 
OUTPUT JCL statement parameter 17-42 
description 17-42 
example 17-43 
location in JCL 17-43 
overrides 17-43 
subparameters 17-42 
JESJCL 

subparameter of //*FORMAT DDNAME 
parameter 21-12 
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JESMSG 

subparameter of //*FORMAT DDNAME 

parameter 2 1 -12 
JES2 

description 20-1 
location in JCL 20-1 
statements 

format for 3-4 
introduced iii, 1-1 
JESS 

description 21-1 
examples 21-2 
location in JCL 21-1 
statements 

format for 3-4 
introduced iii, 1-1 
JGLOBAL 

subparameter of //*MAIN SYSTEM 
parameter 21-36 
JLOCAL 

subparameter of //*MAIN SYSTEM 
parameter 21-36 
JOB 

JCL statement 15-1 
comments field 15-4 
description 15-1 
examples 15-4 
location in JCL 15-4 
name field 15-1 
operation field 1 5-2 
parameter field 15-2 
subparameter of //*MAIN MSS parameter 21-33 
subparameter of //*MAIN SETUP 
parameter 21-35 
job 

background or batch jobs 

affect on DD TERM parameter 10-137 
beginning of 15-1 
control 

tasks needed for iii 
definition 2-1 
dependent 

specifying in JES3 system 21-40 
entering 2-1 
foreground jobs 

affect on DD TERM parameter 10-137 
nonstandard processing 

described 21-49 
processing 2-2 
processing of 

controlling, in JES3 system 21-49 
specifying control of 15-1 
specifying control of in JES3 system 21-25 
restarting 

with EXEC COND parameter 14-12 
standard processing 
described 21-49 
job control language 

See JCL (job control language) 
job log 



assigning to an output class 15-17 

cataloged procedure statements in 6-2 

controlling listing from 15-19 

jn=stream procedure statements in 6-2 

job control statements in 6-2 

listing of 6-1 

specifying processing of 1 7-42 

statements in listing 6-1 

symbolic parameters in 6-1 
job-level 

OUTPUT JCL statements 17-6 
JOBCAT DD statement 

description 11-2 

example 11-3 

location in JCL 11-2 

overriding with STEPCAT DD statement 1 1-8 

parameters 11-2 

relationship to other control statements 11-2 

relationship to STEPCAT 1 1-2 
jobclass 

subparameter of JOB CLASS parameter 15-11 
JOBLIB DD statement 

description 11-4 

examples 11-6 

location in JCL 11-6 

overriding for a step 11-5, 11-11 

parameters 11-4 

relationship to other control statements 1 1 -5 

relationship to STEPLIB 11-6 

with COND = ONLY parameter 14-12 
jobname 

coding 15-1 

subparameter of //*NET NETREL 
parameter 21-42 

subparameter of //*NET RELEASE 
parameter 21-44 
JOURNAL 

parameter of JES3 //*MAIN statement 21-32 
JSTTEST 

subparameter of EXEC PGM parameter 14-23 



K 



KEEP 

subparameter of //*NET ABCMP parameter 21-41 

subparameter of DD DISP parameter 10-65, 10-66 
KEYLEN 

subparameter of DD DCB parameter 10-46 
keys, data set 
keyword 

See parameters, keyword 



subparameter of AMP OPTCD 
subparameter 10-19 
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subparameter of DCB BUFOFF 

subparameter 10-43 
subparameter of DCB OPTCD 
subparameter 10-48, 10-50 
LABEL 

DD statement parameter 10-98 
defaults 10-102 
description 10-98 
examples 10-103 

relationship to other control statements 10-102 
relationship to other parameters 10-102 
subparameters 1 0-99 
label, data set 

copying attributes from 1 0-39 
specifying in DD LABEL parameter 10-99 
type copied when DD statement referenced 10-151 
LE 

subparameter of EXEC COND parameter 14-10 
subparameter of JOB COND parameter 15-13 
length, block 

See block length 
library 
private 

specifying for job 1 1 -4 
specifying for step 11-9 
procedure 

adding to 5-2 
use for procedures 2-1 
LIMCT 

subparameter of DD DCB parameter 10-46 
limit 

subparameter of //* FORMAT THRESHLD 
parameter 21-18 
subparameter of OUTPUT JCL THRESHLD 
parameter 17-54 
limiting, of output 

by specifying DD OUTLIM parameter 10-1 10 
maximum size of sysout data set 17-54 
of lines per printed page 15-7, 17-45 
LINDEX 

OUTPUT JCL statement parameter 17-44 
defaults 17-44 
description 17-44 
example 17-44 

relationship to other parameters 17-44 
subparameter 17-44 
parameter of JES2 /*OUTPUT statement 20-20 
LINE 

subparameter of OUTPUT JCL PRMODE 
parameter 17-51 
linect 

JES2 format subparameter of JOB accounting 

information 15-7 
OUTPUT JCL statement parameter 17-45 
defaults 17-45 
description 17-45 
example 17-45 
subparameter 17-45 
parameter of JES2 /*JOBPARM statement 20-6 
parameter of JES2 /*OUTPUT statement 20-21 



LINES 

parameter of JES2 /*JOBPARM statement 20-6 

parameter of JES3 //*MAIN statement 21-32 
lines 

JES2 format subparameter of JOB accounting 
information 1 5-6 
LOCAL 

parameter of JES2 /* ROUTE statement 20-26 

subparameter of /*OUTPUT DEST 
parameter 20-17 

subparameter of DD DEST parameter 10-59 

subparameter of OUTPUT JCL DEST 
parameter 1 7-28 
LOG 

See also job log 

subparameter of OUTPUT JCL JESDS 
parameter 1 7-42 
log 

JES2 format subparameter of JOB accounting 
information 15-7 
LOW 

subparameter of //*MAIN lORATE 
parameter 21-32 
lowercase 

in syntax 4-2 
LRECL 

subparameter of DD DCB parameter 10-46 
LREGION 

parameter of JES3 //*MAIN statement 21-33 
LT 

subparameter of EXEC COND parameter 14-10 

subparameter of JOB COND parameter 15-13 
LTM 

subparameter of DD LABEL parameter 10-100 



M 



M 



m 



subparameter of DCB OPTCD subparameter 10-50 
subparameter of DCB RECFM 
subparameter 10-51, 10-52 



subparameter of //* FORMAT CHNSIZE 
parameter 21-13, 21-21 
MACRF operand of DCB macro instruction 

when coding DUMMY 10-83 
main service 

in job processing 21-49 
main-name 

subparameter of //*MAIN SYSTEM 
parameter 21-36 
margins 

See indexing of print margins 
mass storage system 

See MSS 
MED 

subparameter of //*MAIN lORATE 
parameter 21-32 
member 
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subparameter of DCB INTVL subparameter 10-45 
subparameter of DD DSNAME parameter 10-79, 
10-80 
membername 

subparameter of OUTPUT JCL FORMDEF 

parameter 17-36 
subparameter of OUTPUT JCL PAGEDEF 
parameter 17-48 
messages 

from functional subsystem, printing of 17-50 
specifying processing of 17-42 
subparameter of JOB MSGLEVEL 

parameter 15-19 
to operator, in JES3 system 21-47 
method, access 

See individual access methods 
minutes 

subparameter of EXEC TIME parameter 14-31 
subparameter of JOB TIME parameter 15-37 
MOD 

subparameter of DD DISP parameter 10-64 
MODE 

parameter of JES3 //*DATASET statement 21-5 
subparameter of DD DCB parameter 10-47 
mode 

process, for printing 

specifying on OUTPUT JCL statement 17-51 
modification, of printed output 

by specifying copy-modification module 10-105, 
17-46 
MODIFY 

DD statement parameter 10-105 
defaults 10-106 
description 10-105 
example 10-106 
overrides 10-106 

relationship to other control statements 10-106 
relationship to other parameters 10-106 
subparameters 10-105 
OUTPUT JCL statement parameter 17-46 
defaults 17-47 
description 17-46 
example 17-47 
overrides 17-47 

relationship to other parameters 17-47 
subparameters 17-46 
parameter of JES2 /*OUTPUT statement 20-21 
parameter of JES3 //*FORMAT PR 
statement 21-17 
modifying procedure DD statements 

coding 5-3 
MODTRC 

parameter of JES2 /*OUTPUT statement 20-21 
module 

subparameter of AMP SYNAD 
subparameter 10-20 
module-name 

subparameter of /*OUTPUT MODIFY 
parameter 20-21 



subparameter of //*FORMAT MODIFY 

parameter 21-17 
subparameter of DD MODIFY parameter 10-105 
subparameter of OUTPUT JCL MODIFY 
parameter 17-46 
mounting of volumes 
deferred 

specifying 10-144 
parallel 

specifying 10-144 
MSG 

subparameter of OUTPUT JCL JESDS 
parameter 17-42 
MSGCLASS 

JOB statement parameter 15-17 
defaults 15-17 
description 15-17 
examples 15-18 
subparameter 15-17 
subparameter of //*DATASET DDNAME 
parameter 21-6 
MSGLEVEL 

JOB statement parameter 15-19 
defaults 15-20 
description 15-19 
examples 15-20 
subparameters 15-19 
MSS 

affect of deferred mounting 10-144 
parameter of JES3 //*MAIN statement 21-33 
specifying in UNIT parameter 10-143 
specifying space for 10-125 
specifying volumes 10-151 
unit count for 10-144 
with DD MS VGP parameter 10-107 
MSVGP 

DD statement parameter 10-107 
description 10-107 
examples 10-109 

relationship to other parameters 10-108 
subparameters 10-107 
multivolume data set 

See data set, multivolume 
MXIG 

subparameter of DD SPACE parameter 10-124 



N 



N 

See also NO 

subparameter of /*JOBPARM BURST 

parameter 20-5 
subparameter of /*JOBPARM RESTART 

parameter 20-6 
subparameter of /*OUTPUT BURST 

parameter 20-16 
subparameter of DCB PCI subparameter 10-50 
n or number 
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subparameter of /*JOBPARM BYTES 

parameter 20-5 
subparameter of /*JOBPARM CARDS 

parameter 20-5 
subparameter of /*JOBPARM COPIES 

parameter 20-5 
subparameter of /*JOBPARM LINECT 

parameter 20-6 
subparameter of /*JOBPARM LINES 

parameter 20-6 
subparameter of /*JOBPARM PAGES 

parameter 20-6 
subparameter of /*JOBPARM TIME 

parameter 20-7 
subparameter of /*OUTPUT CKPTLNS 

parameter 20-16 
subparameter of /*OUTPUT CKPTPGS 

parameter 20-16 
subparameter of /*OUTPUT COMPACT 

parameter 20-16 
subparameter of /*OUTPUT COPIES 

parameter 20-16 
subparameter of /*OUTPUT INDEX 

parameter 20-20 
subparameter of /*OUTPUT LINDEX 

parameter 20-20 
subparameter of /*OUTPUT LINECT 

parameter 20-21 
subparameter of //* FORMAT CHNSIZE 

parameter 21-13, 21-21 
subparameter of //*FORMAT COPIES 

parameter 21-14, 21-22 
subparameter of //*FORM AT PRTY 

parameter 21-17 
subparameter of //*M AIN BYTES 

parameter 21-27 
subparameter of //*MAIN CARDS 

parameter 21-28 
subparameter of //*MAIN LINES parameter 21-32 
subparameter of //*MAIN PAGES 

parameter 21-34 
subparameter of //*NET DEVPOOL 

parameter 21-42 
subparameter of //*NET NHOLD parameter 21-43 
subparameter of //*NET RELSCHCT 

parameter 21-44 
subparameter of //*NETACCT ACCT 

parameter 21-45 
subparameter of AMP BUFND parameter 10-18 
subparameter of AMP BUFNl parameter 10-18 
subparameter of AMP STRNO parameter 10-20 
subparameter of DCB BUFOFF 

subparameter 10-43 
subparameter of DCB GNCP subparameter 10-45 
subparameter of DCB INTVL subparameter 10-45 
subparameter of DCB NCP parameter 10-47 
subparameter of DCB RKP subparameter 10-53 
subparameter of DCB THRESH 

subparameter 10-53 
subparameter of DD COPIES parameter 10-31 



subparameter of DD OUTLIM parameter 10-110 
subparameter of EXEC DYNAMNBR 

parameter 14-17 
subparameter of EXEC PERFORM 

parameter 14-20 
subparameter of JOB PERFORM parameter 1 5-24 
subparameter of LABEL RETPD 

subparameter 10-101 
subparameter of OUTPUT JCL CKPTPAGE 

parameter 17-15 
subparameter of OUTPUT JCL CKPTSEC 

parameter 17-16 
subparameter of OUTPUT JCL COPIES 

parameter 17-22 
subparameter of OUTPUT JCL INDEX 

parameter 17-41 
subparameter of OUTPUT JCL LINDEX 

parameter 17-44 
subparameter of OUTPUT JCL LINECT 

parameter 1 7-45 
subparameter of OUTPUT JCL PRTY 

parameter 17-53 
name 

in name field of OUTPUT JCL statement 17-1 
parameter of JES2 /* ROUTE statement 20-26 
qualified 

for data set 10-78 
subparameter of /*OUTPUT DEST 

parameter 20-17 
subparameter of //*FORMAT EXTWTR 

parameter 21-15, 21-23 
subparameter of //*NET NETID parameter 21-41 
subparameter of DD DEST parameter 10-59 
subparameter of OUTPUT JCL DEST 

parameter 17-28 
subparameter of OUTPUT JCL WRITER 

parameter 17-61 
unqualified 

for data set 10-78 
NC 

NORMAL parameter of JES3 //*NET 

statement 21-40 
subparameter of EXEC RD parameter 14-27 
subparameter of JOB RD parameter 1 5-30 
NCK 

subparameter of AMP CROPS subparameter 10-18 
NCP 

subparameter of DD DCB parameter 10-47 
NE 

subparameter of EXEC COND parameter 14-10 
subparameter of JOB COND parameter 15-13 
NET 

subparameter of //*NET DEVPOOL 

parameter 21-42 
NETID 

parameter of JES3 //*NET statement 21-41 
subparameter of //*NET NETREL 

parameter 21-42 
NETREL 

parameter of JES3 //*NET statement 21-42 
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network-account-number 

parameter of JES2 /*NETACCT statement 20-1 1 
NEW 

subparameter of DD DISP parameter 10-63 
new-password 

subparameter of JOB PASSWORD 

parameter 1 5-23 
NHOLD 

parameter of JES3 //*NET statement 21-43 
NL 

subparameter of DD LABEL parameter 10-100 
Nn 

parameter of JES2 /* ROUTE statement 20-26 
parameter of JES2 /*XEQ statement 20-32 
parameter of JES2 /*XMIT statement 20-33 
subparameter of /*OUTPUT DEST 

parameter 20-17, 20-18 
subparameter of DD DEST parameter 10-59, 

10-60 
subparameter of OUTPUT JCL DEST 

parameter 17-28 
nnnnK 

subparameter of //*M AIN LREGION 

parameter 21-33 
NO 

subparameter of //*DATASET DDNAME 

parameter 21-6 
subparameter of //*FORMAT FORMS 

parameter 21-23 
subparameter of //*MAIN EXPDTCHK 

parameter 21-30 
subparameter of //*MAIN HOLD parameter 21-31 
subparameter of //*MAIN JOURNAL 

parameter 21-32 
subparameter of //*MAIN RINGCHK 

parameter 21-35 
subparameter of //*NET DEVRELSE 

parameter 21-42 
subparameter of //*NET OPHOLD 

parameter 21-43 
subparameter of DD BURST parameter 10-22 
subparameter of DD HOLD parameter 10-96 
subparameter of OUTPUT JCL BURST 

parameter 17-9 
subparameter of OUTPUT JCL DEFAULT 

parameter 17-25 
subparameter of OUTPUT JCL PIMSG 

parameter 17-50 
subparameter of OUTPUT JCL TRC 

parameter 17-56 
node 

affect on JES2 /*JOBPARM COPIES 

parameter 20-8 
of execution 20-8 
subparameter of DD DEST parameter 10-60, 

10-61 
nodename 

parameter of JES2 /*NOTIFY statement 20-12 
parameter of JES2 /* ROUTE statement 20-26, 

20-27 



parameter of JES2 /*XEQ statement 20-32 
parameter of JES2 /*XMIT statement 20-33 
parameter of JES3 //*ROUTE XEQ 21-52 

subparameter of /*OUTPUT DEST 

parameter 20-18 
subparameter of /7*FORMAT DEST 

parameter 21-15, 21-23 
subparameter of //*MAIN ORG parameter 21-33 
subparameter of DD DEST parameter 10-61 
subparameter of OUTPUT JCL DEST 
parameter 17-29 
subparameter of OUTPUT JCL DEST 
parameter 17-29 
NOHO 

subparameter of //*NET NRCMP parameter 21-43 
NOKP 

subparameter of //* NET ABCMP parameter 21-41 
NOLOG 

parameter of JES2 /* JOBPARM statement 20-6 
NONE 

subparameter of /*OUTPUT FLASH 

parameter 20-19 
subparameter of //*MAIN FETCH 

parameter 21-31 
subparameter of DD FLASH parameter 10-90 
subparameter of OUTPUT JCL FLASH 
parameter 17-33 
nonpageable storage 

See storage, real (nonpageable) 
nonspecific volumes 

See volumes, nonspecific requests 
nonstandard labels 

See NSL 
NOPWREAD 

subparameter of DD LABEL parameter 10-101 
NORMAL 

parameter of JES3 //*NET statement 21-41 
normal termination 

See termination, normal 
notation 

for syntax 4-1 
notification 

of job completion 15-21 
receiving 15-21 
NOTIFY 

JOB statement parameter 15-21 
description 15-21 
example 15-21 

relationship to JES2 /* JOBPARM SYSAFF 
parameter 15-21 
subparameter 15-21 
NR 

NETREL parameter of JES3 //*NET 

statement 21-40 
subparameter of EXEC RD parameter 14-26 
subparameter of JOB RD parameter 15-30 
NRC 

subparameter of AMP CROPS subparameter 10-18 
NRCMP 

parameter of JES3 //*NET statement 21-43 
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NRE 

subparameter of AMP CROPS subparameter 10-18 
NSL 

subparameter of DD LABEL parameter 10-100 
NTM 

subparameter of DD DCB parameter 10-47 
null 

JCL statement 16-1 
description 16-1 
example 16-2 
location in JCL 16-1 
subparameter of //*FORMAT DDNAME 
parameter 21-12, 21-21 
NULLFILE 

subparameter of DD DSNAME parameter 10-80 
number parameter 
See n or number 



O 

O 

subparameter of DCB MODE subparameter 10-47 
OFF 

subparameter of //* FORMAT OVLY 
parameter 21-17 
OH 

OPHOLD parameter of JES3 //*NET 
statement 21-40 
OLD 

subparameter of DD DISP parameter 10-63 
omitting 

ddname from DD statement 10-2 
ON 

subparameter of //* FORMAT OVLY 
parameter 21-17 
ONLY 

subparameter of EXEC COND parameter 14-11 
operating system 

contents 2-1 
operator 

messages to, in JESS system 21-47 

subparameter of EXEC COND parameter 14-10 

subparameter of JOB COND parameter 15-13 
operator commands 

entered through JCL command statement 7-1 

entered through JES2 command statement 20-2 

entered through JES3 command statement 21-3 
OPHOLD 

parameter of JES3 //*NET statement 21-43 
OPTCD 

subparameter of DD AMP parameter 10-19 

subparameter of DD DCB parameter 10-48 
ORG 

parameter of JES3 //*MAIN statement 21-33 
organization 

subparameter of DCB DSORG 
subparameter 10-44 
OUT 

subparameter of DD LABEL parameter 10-101 



OUTLIM 

DD statement parameter 10-110 
default 10-110 
description 10-110 
example 10-111 

relationship to other control statements 10-111 
relationship to other parameters 10-1 10 
subparameter 10-110 
OUTPUT 

DD statement parameter 10-112 
defaults 10-113 
description 10-112 
examples 10-115 
location in JCL 10-114 
overrides 10-113 

relationship to other parameters 10-114 
subparameters 10-113 
JCL statement 17-1 
comments field 17-5 
default, defined 17-5 
description 17-1 

example of job and step-level statements 17-7 
job-level statements 17-6 
location in JCL 17-6 
location in procedures 17-6 
location of default statements 1 7-6 
name field 17-1 
operation field 17-2 
overrides 1 7-7 
parameter field 17-2 
relationship to DD statement COPIES 

parameter 10-33 
relationship to JES2 /*OUTPUT 

statement 17-8 
relationship to JES3 //*FORMAT 

statement 17-8 
relationship to sysout DD statement 17-7 
step-level statements 17-6 
limiting from job 15-6 

specifying number of copies 10-31, 17-22, 21-14 
output service 

in job processing 21-49 
output-group 

subparameter of OUTPUT JCL GROUPID 
parameter 17-39 
overflow 

holding 10-44 
overlay-name 

subparameter of /*OUTPUT FLASH 
parameter 20-19 

subparameter of //*FORMAT FLASH 
parameter 21-16 
subparameter of DD FLASH parameter 10-90 
subparameter of OUTPUT JCL FLASH 
parameter 17-33 
overlay, forms 

See flashing 
overrides, of cataloged and in-stream procedure 
statements 

of DD statements 5-3 
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of EXEC statement parameters 5-2 
of OUTPUT JCL statements 5-3 
with DD DUMMY statement 10-83 
OVFL 

parameter of JES3 //*FORMAT PR 
statement 21-17 



subparameter of DCB FUNC subparameter 10-45 
subparameter of DD UNIT parameter 10-144 

P 

parameter of /*PRIORITY statement 20-23 
PAGE 

subparameter of OUTPUT JCL PRMODE 
parameter 17-51 
pageable storage 

See storage, virtual (pageable) 
PAGEDEF 

OUTPUT JCL statement parameter 17-48 
description 17-48 
example 17-49 
overrides 17-49 
subparameter 17-48 
PAGES 

parameter of JES2 /*JOBPARM statement 20-6 

parameter of JES3 //*MAIN statement 21-34 
pages, in printed output 

limiting length of 15-7, 17-45 
pano 

JES2 format subparameter of JOB accounting 
information 15-6 
parameter 

See individual parameters 
parameters, keyword 

on DD statement 10-3 

on EXEC statement 14-2 

on EXEC statement that calls procedure 14-4 

on JOB statement 15-2 

on OUTPUT JCL statement 17-2 

syntax for 3-3 

warning on other uses of 3-3 
parameters, mutually exclusive 

table of, for DD statement 22-2 
parameters, positional 

on DD statement 10-3 

on EXEC statement 14-2 

on JOB statement 15-2 

optionally required by installation 15-5, 15-25 

syntax for 3-3 
parameters, symbolic 

assigning values to 5-10 

cautions about leading and trailing commas 
around 5-11 

coding of 5-8 

default values for 5-10 

examples 5-12 

length of assigned value for 5-10 



location of 5-8 
multiple values for 5-10 
nullifying 5-10 
purpose of 5-8 
syntax for 5-8 
PARM 

EXEC statement parameter 14-18 
description 14-18 
examples 14-19 
subparameter 14-18 
partition-name 

subparameter of //*MAIN SPART 
parameter 21-36 
PASS 

subparameter of DD DISP parameter 10-65 
passed data sets 

See data set, passed 
PASSWORD 

JOB statement 15-22 
description 15-22 
examples 1 5-23 

relationship to other parameters 15-23 
subparameters 15-23 
subparameter of DD LABEL parameter 10-101 
subparameter of JOB PASSWORD 
parameter 15-23 
passwords 

for protection of data sets 10-100 
password 1 

parameter of JES2 /*SIGNON statement 20-3 1 
parameter of JES3 /*SIGNON statement 21-55 
password2 

parameter of JES2 /*SIGNON statement 20-3 1 
parameter of JES3 /*SIGNON statement 21-56 
PC 

NRCMP parameter of JES3 //*NET 
statement 21-40 
PCAN 

character set for 1403 and 3203 Model 5 10-140, 
17-59 
PCHN 

character set for 1403 and 3203 Model 5 10-140, 
17-59 
PCI 

subparameter of DD DCB parameter 10-50 
PEND 

JCL statement 18-1 
comments field 18-1 
description 18-1 
examples 18-2 
location in JCL 18-2 
name field 18-1 
operation field 18-1 
PERFORM 

EXEC statement parameter 14-20 
defaults 14-20 
description 14-20 
examples 14-21 
overrides 14-20 
subparameter 14-20 
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JOB statement parameter 15-24 
defaults 15-24 
description 15-24 
example 15-24 
overrides 15-24 
subparameter 15-24 
performance group 

specifying on the EXEC statement 14-20 
specifying on the JOB statement 1 5-24 
PGM 

EXEC statement parameter 14-22 
description 14-22 
examples 14-23 
subparameters 14-22 
location of specified program 11-4, 11-9 
PIMSG 

OUTPUT JCL statement parameter 17-50 
defaults 17-50 
description 17-50 
example 17-50 
subparameters 17-50 
PN 

character set for 1403 and 3203 Model 5 10-140, 
17-59 
PNAME 

parameter of JES3 //*NETACCT statement 21-45 
PO 

subparameter of DCB DSORG 
subparameter 10-44 
position of tape data set 

See data-set-sequence-number 
positional 

See parameters, positional 
POU 

subparameter of DCB DSORG 
subparameter 10-44 
PR 

parameter of JES3 //*FORMAT PR 
statement 21-11 
PRDMP service aid 

to print dump 11-14 
primary-qty 

subparameter of //*MA1N TRKGRPS 

parameter 21-37 
subparameter of DD SPACE parameter for specific 

requests 10-124 
subparameter of DD SPACE parameter for system 
assignment 10-122 
PRINT 

parameter of JES2 /* ROUTE statement 20-25 
subparameter of //*MAIN FAILURE 
parameter 21-30 
Print Services Facility 

See PSF (Print Services Facility) 
printing, of output data set 

controlling spacing in output 17-21, 21-14 
processing instructions for, in JES3 system 21-10 
priority 

APG (automatic priority group) 
assignment of 14-16 



dispatching 

specifying 14-15 
initiation or selection 

specifying 15-27 
of lines for transmission 10-43 
output queue 

specifying, for sysout data set 17-53 
queue selection 

specifying 15-27 
requested on JES2 /*PRIORITY statement 20-23 
subparameter of JOB PRTY parameter 15-27 
PRIVATE 

subparameter of DD VOLUME parameter 10-148 
PRMODE 

OUTPUT JCL statement parameter 17-51 

defaults 17-51 

description 17-51 

example 17-52 

subparameters 17-51 
PROC 

EXEC statement parameter 14-24 

description 14-24 

examples 14-24 

subparameter 14-24 
JCL statement 19-1 

comments field 19-2 

description 19-1 

examples 19-3 

location in JCL 19-2 

name field 19-2 

operation field 19-2 

overrides 19-2 

parameter field 19-2 
parameter of JES3 //*MAIN statement 21-34 
procedure-name 

subparameter of EXEC PROC parameter 14-24 
procedures, cataloged and in-stream 
affect of parameters on calling EXEC 

statement 14-4 
calling 14-24 
cataloging 5-2 
ddname when overriding or adding to 

procedure 10-2 
definition 2-1 
description 5-1 
effect of PROC parameter on other parameters and 

following statements 14-24 
examples 5-6 

examples, showing symbolic parameters 5-12 
in-stream data for 10-13 
indicating end for in-stream 18-1 
indicating start of 19-1 
location of DD statements when overriding or 

adding to procedure 10-10 
maxi mum pe r j ob 5-1 
modifying DD statements 5-3 
modifying OUTPUT JCL statements 5-3 
overriding ACCT parameter in 14-6 
overriding ADDRSPC parameter in 14-8 
overriding COND parameter in 14-11 
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overriding DPRTY parameter in 14-16 

overriding DYNAMNBR parameter in 14-17 

overriding EXEC statement parameters 5-2 

overriding FARM parameter in 14-19 

overriding PERFORM parameter in 14-21 

overriding RD parameter in 14-27 

overriding REGION parameter in 14-30 

overriding TIME parameter in 14-32 

statements as listed in job log 6-2 

statements valid in procedures 5-1 

symbolic parameters in 5-8 

testing 2-1, 5-1 

using 5-1 
process-mode 

subparameter of OUTPUT JCL PRMODE 
parameter 17-51 
processing, of data sets 

for input or output 10-101 

with multiple references in DD OUTPUT 
parameter 10-114 
processor-id 

subparameter of //*MA1N ACM AIN 
parameter 21-27 
PROCLIB 

parameter of JES2 /*JOBPARM statement 20-6 
procname 

subparameter of DD QNAME parameter 10-120 
procstepname 

subparameter of EXEC ACCT parameter 14-6 

subparameter of EXEC ADDRSPC 
parameter 14-8 

subparameter of EXEC COND parameter 14-11 

subparameter of EXEC DPRTY parameter 14-16 

subparameter of EXEC DYNAMNBR 
parameter 14-17 

subparameter of EXEC PARM parameter 14-19 

subparameter of EXEC PERFORM 
parameter 14-21 

subparameter of EXEC RD parameter 14-27 

subparameter of EXEC REGION parameter 14-30 

subparameter of EXEC TIME parameter 14-32 
profile, discrete 

See RACF (resource access control facility) 
PROGRAM 

subparameter of //* FORMAT CONTROL 
parameter 21-14 

subparameter of OUTPUT JCL CONTROL 
parameter 17-21 
program 

executing 14-22 

location of executable programs 11-4, 11-9 
program control 9-1 
program control statements 9-2 

end of 13-1 
program-name 

subparameter of EXEC PGM parameter 14-22 
programmer's-name 

JOB statement parameter 15-25 
description 15-25 
examples 15-25 



parameter 15-25 
subparameter of //*NETACCT PNAME 
parameter 21-45 
PROTECT 

DD statement parameter 10-116 
description 10-116 
examples 10-119 

relationship to other parameters 10-117 
requirements for protecting direct access data 

set 10-119 
requirements for protecting tape data 

set 10-117 
requirements for protecting tape volume 10-118 
subparameters 10-117 
protection 
of data sets 

by passwords 10-100 
through DD PROTECT parameter 10-116 
PRTSP 

subparameter of DD DCB parameter 10-51 
PRTY 

JOB statement parameter 1 5-27 
defaults 15-27 
description 15-27 
example 15-28 
overrides 1 5-28 
subparameter 15-27 
OUTPUT JCL statement parameter 17-53 
defaults 17-53 
description 17-53 
example 17-53 
overrides 1 7-53 
subparameter 1 7-53 
parameter of JES3 //*FORMAT PR 
statement 21-17 
PS 

subparameter of DCB DSORG 
subparameter 10-44 
PSF (Print Services Facility) 

for printing Hne-mode data 17-52 
specifying how to print data set 17-36, 17-48 
specifying table reference character codes for, in 

JES2 system 17-56 
with DD CHARS parameter 10-25 
with DD UCS parameter 10-140 
with OUTPUT JCL CHARS parameter 17-12 
with OUTPUT JCL UCS parameter 17-59 
PSU 

subparameter of DCB DSORG 
subparameter 10-44 
PU 

parameter of JES3 //*FORMAT PU 
statement 21-21 
PUNCH 

parameter of JES2 /* ROUTE statement 20-25 
punching, of output data set 

processing options for, in JES3 system 21-20 
purge service 

in job processing 21-49 
Pll 
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character set for 321 1 10-140, 17-59 



subparameter of DCB OPTCD subparameter 10-49 
QISAM (queued indexed sequential access method) 

subparameters of DD DCB parameter 10-42 
QN 

character set for 1403 and 3203 Model 5 10-140, 
17-59 
QNAME 

DD statement parameter 10-120 
description 10-120 
examples 10-120 

relationship to other parameters 10-120 
subparameters 1 0- 1 20 
QNC 

character set for 1403 and 3203 Model 5 10-140, 
17-59 
QSAM (queued sequential access method) 

subparameters of DD DCB parameter 10-42 
with DD CHKPT parameter 10-27 
qualified 

See name 
queued indexed sequential access method 

See QISAM (queued indexed sequential access 
method) 
queued sequential access method 

See QSAM (queued sequential access method) 



R 



R 

parameter of JES3 /*SIGNON statement 21-55 
subparameter of //*NET ABNORMAL 

parameter 21-41 
subparameter of //*NET NORMAL 

parameter 21-41 
subparameter of DCB BFTEK subparameter 10-42 
subparameter of DCB CPRI subparameter 10-43 
subparameter of DCB FUNC subparameter 10-45 
subparameter of DCB MODE subparameter 10-47 
subparameter of DCB OPTCD 

subparameter 10-48, 10-50 
subparameter of DCB PCI subparameter 10-50 
subparameter of EXEC RD parameter 14-26 
subparameter of JOB RD parameter 15-30 
RACF (resource access control facility) 
protection through DD PROTECT 

parameter 10-116 
specifying new password 15-22 
specifying RACF-defined group 15-15 
specifying RACF-defined password 15-22 
specifying RACF-defined user 15-42 
using discrete profile 10-116 
RCK 

subparameter of AMP CROPS subparameter 10-18 



RD 

EXEC statement parameter 14-25 
defaults 14-27 
description 14-25 
examples 14-28 
overrides 14-27 

relationship to other control statements 14-27 
subparameters 14-26 
JOB statement parameter 15-29 
defaults 15-31 
description 15-29 
examples 15-31 
overrides 15-31 

relationship to other control statements 1 5-3 1 
subparameters 1 5-30 
RDJFCB macro instruction 10-10 
reader, internal 
definition 2- 1 

submitting jobs to 20-1, 21-1 
REAL 

subparameter of EXEC ADDRSPC 

parameter 14-7 
subparameter of JOB ADDRSPC parameter 15-9 
real storage 

See storage, real (nonpageable) 
reassignment, of printer 10-26 
RECFM 

subparameter of DD AMP parameter 10-20 
subparameter of DD DCB parameter 10-51 
record format 

See RECFM 
records 

specifying length of 10-46 
REF 

subparameter of DD VOLUME parameter 10-150 
references 
backward 

coding of 10-57 
examples 4-7 
explanation and coding 4-6 
to concatenated data sets 10-10 
with EXEC COND parameter 14-12 
explicit 

to OUTPUT JCL statements 17-6, 17-26 
forward 

to concatenated data sets 10-10 
implicit 

specifying, using OUTPUT JCL DEFAULT 

parameter 17-25 
to OUTPUT JCL statements 17-6, 17-26 
with DD DUMMY statement 10-83 
REGION 

EXEC statement parameter 14-29 
defaults 14-30 
description 14-29 
examples 14-30 
overrides 14-30 

relationship to the EXEC ADDRSPC 
parameter 14-30 
subparameters 14-29 
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JOB statement parameter 15-32 
default 15-33 
description 15-32 
examples 15-33 
overrides 15-33 
relationship to the JOB ADDRSPC 

parameter 15-33 
subparameters 15-32 
region 

specifying size of 1 4-29, 1 5-32 
region size, default 14-30, 15-33 
rel 

subparameter of //*MAIN DEADLINE 
parameter 21-29 
RELEASE 

parameter of JES3 //*NET statement 2 1 -44 
RELSCHCT 

parameter of JES3 //*NET statement 21-44 
remote 

subparameter of //* FORMAT DEST 

parameter 21-15, 21-23 
subparameter of //*MAIN ORG parameter 21-33 
subparameter of OUTPUT JCL DEST 
parameter 17-29 
remote job entry (RJE) 

See SNA (systems network architecture) RJE or 
RJP (remote job entry or processing) 
remote job processing (RJP) 

See SNA (systems network architecture) RJE or 
RJP (remote job entry or processing) 
RBMOTEnnn 

parameter of JES2 /*SIGNON statement 20-30 
RESERVE 

subparameter of DD DCB parameter 10-53 
resource access control facility 

See RACE (resource access control facility) 
RESTART 

JOB statement parameter 15-34 
cautions with coding 15-35 
description 15-34 
examples 15-36 

relationship to other control statements 15-35 
subparameters 15-34 
parameter of JES2 /*JOBPARM statement 20-6 
subparameter of //*MA1N FAILURE 

parameter 21-30 
with EXEC COND parameter 14-12 
restart definition 

See RD 
restarting, of execution 
at checkpoint 15-34 
at step 15-34 

requesting for all steps in job 15-29 
requesting for step 14-25 
specifying 15-34 
RETAIN 

subparameter of DD VOLUME parameter 10-148 
retention, of data set 

specifying in DD LABEL parameter 10-101 
retention, of volume 



specifying by RETAIN subparameter 10-148 
RETPD 

subparameter of DD LABEL parameter 10-101 
return code tests 

See tests, return code 
RINGCHK 

parameter of JES3 //*MAIN statement 21-35 
RJE (remote job entry) 

See SNA (systems network architecture) RJE or 
RJP (remote job entry or processing) 
RJP (remote job processing) 

See SNA (systems network architecture) RJE or 
RJP (remote job entry or processing) 
RKP 

subparameter of DD DCB parameter 10-53 
RL 

RELEASE parameter of JES3 //*NET 
statement 21-40 
RLSE 

subparameter of DD SPACE parameter 
Rm 

parameter of JES2 /* ROUTE statement 
subparameter of /*OUTPUT DEST 

parameter 20-18 
subparameter of DD DEST parameter 
subparameter of OUTPUT JCL DEST 
parameter 17-28 
RMn 

parameter of JES2 /*ROUTE statement 
parameter of JES2 /*SlGNON statement 
subparameter of /*OUTPUT DEST 

parameter 20-18 
subparameter of DD DEST parameter 10-60 
subparameter of OUTPUT JCL DEST 
parameter 1 7-29 
RMTn 

parameter of JES2 /* ROUTE statement 20-26 
parameter of JES2 /*SIGNON statement 20-3 1 
subparameter of /*OUTPUT DEST 

parameter 20-18 
subparameter of DD DEST parameter 10-60 
subparameter of OUTPUT JCL DEST 
parameter 17-29 
RN 

character set for 1403 and 3203 Model 5 10-140, 
17-59 



10-123 



20-26 



10-60 



20-26 
20-31 



Rn 



20-26 



parameter of JES2 /* ROUTE statement 

subparameter of /*OUTPUT DEST 
parameter 20-18 

subparameter of DD DEST parameter 

subparameter of OUTPUT JCL DEST 
parameter 17-29 
RNC 

subparameter of EXEC RD parameter 

subparameter of JOB RD parameter 
ROOM 

parameter of JES2 /*JOBPARM statement 20-7 

parameter of JESS //*NETACCT statement 21=45 
room 



10-60 



14-26 
15-30 
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JES2 format subparameter of JOB accounting 

information 15-6 
subparameter of //*NETACCT ROOM 
parameter 21-45 
ROUND 

subparameter of DD SPACE parameter 10-124 
RS 

RELSCHCT parameter of JES3 //*NET 
statement 21-40 



subparameter of //*FORMAT STACKER 
parameter 21-18 

subparameter of DCB BFTEK subparameter 10-42 

subparameter of DCB CPRI subparameter 10-43 

subparameter of DCB RECFM 
subparameter 10-52 
SCAN 

subparameter of JOB TYPRUN parameter 15-41 
SDGxx 

subparameter of //*NET DEVPOOL 
parameter 21-42 
second-qty 

subparameter of //*MAIN TRKGRPS 
parameter 21-37 

subparameter of DD SPACE parameter 10-122 
seconds 

subparameter of EXEC TIME parameter 14-31 

subparameter of JOB TIME parameter 15-37 
sending to remote node 

of input stream for execution 21-52 
SER 

subparameter of DD VOLUME parameter 10-149 
serial number for volume 

See volumes, serial numbers 
serial-number 

parameter of JES2 /*SETUP statement 20-28 

subparameter of VOLUME = SER 
subparameter 10-149 
SETUP 

parameter of JES3 //*MAIN statement 21-35 

subparameter of //*MAIN FETCH 
parameter 21-31 
SHR 

subparameter of DD DISP parameter 10-64 
SINGLE 

subparameter of //* FORMAT CONTROL 
parameter 21-14 

subparameter of OUTPUT JCL CONTROL 
parameter 17-21 
size, block 

See BLKSIZE 
SKP 

subparameter of DCB EROPT subparameter 10-45 
SL 

subparameter of DD LABEL parameter 10-99 
slash asterisk 



See /* (slash asterisk) 
SN 

character set for 1403 and 3203 Model 5 10-140, 
17-59 
SNA (systems network architecture) RJE or RJP 
(remote job entry or processing) 
DD * statement 10-12 
SPACE 

DD statement parameter 10-121 
description 10-121 
examples 10-125 

relationship to other parameters 10-125 
specifying for mass storage volumes 10-125 
subparameters 10-122 
space, on direct access 

request for specific tasks 

through DD SPACE parameter 10-124 
system assignment of 

through DD SPACE parameter 10-122 
spacing, in printed output 

specifying 17-21, 21-14 
SPART 

parameter of JES3 //*MAIN statement 21-36 
special DD statements 

See DD, special DD statements 
ST 

subparameter of //*MAIN PROC parameter 21-34 
STACK 

subparameter of DD DCB parameter 10-53 
STACKER 

parameter of JES3 //*FORMAT PR 
statement 21-18 
STANDARD 

subparameter of //*FORMAT CHARS 
parameter 21-13 
subparameter of //*FORMAT FLASH 

parameter 21-16 
subparameter of //*FORMAT FORMS 

parameter 21-17, 21-23 
subparameter of //*FORMAT STACKER 

parameter 21-18 
subparameter of //*FORMAT TRAIN 
parameter 21-18 
standard labels 
See SL 
See SUL 
START 
statements 

subparameter of JOB MSGLEVEL 
parameter 15-19 
status 

coded in DD DISP parameter 10-63 
STD 

subparameter of /*JOBPARM FORMS 

parameter 20-6 
subparameter of /*OUTPUT FORMS 

parameter 20-20 
subparameter of OUTPUT JCL FCB 
parameter 17-31 
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subparameter of OUTPUT JCL FLASH 

parameter 17-33 

subparameter of OUTPUT JCL FORMS 
parameter 17-38 

subparameter on OUTPUT JCL CHARS 
parameter 17-11 
STDl 

on DD FCB parameter 10-86 

on OUTPUT JCL FCB parameter 17-31 
STD2 

on DD FCB parameter 10-86 

on OUTPUT JCL FCB parameter 1 7-3 1 
STD3 

on DD FCB parameter 10-86 

on OUTPUT JCL FCB parameter 1 7-3 1 
step 

beginning of 14-1 

definition 2-1 

maximum number 2-1 
step-level 

OUTPUT JCL statements 17-6 
STEPCAT DD statement 

description 11-8 

example 11-8 

location in JCL 11-8 

overriding JOBCAT DD statement 1 1 -8 

parameters 11-8 

relationship to other control statements 1 1 -8 
STEPLIB DD statement 

description 11-9 

examples 11-12 

location in JCL 11-11 

parameters 11-9 

relationship to JOBLIB 11-11 

relationship to other control statements 11-11 
stepname 

coding 14-1 

subparameter of EXEC COND parameter 14-10 

subparameter of JOB RESTART parameter 15-34 
stepname . ddname 

on DD statement referenced by DD DDNAME 
parameter 10-56 

subparameter of //*DATASET DDNAME 
parameter 21-5 

subparameter of //* FORMAT DDNAME 
parameter 21-12, 21-21 

subparameter of //*MAIN SETUP 
parameter 21-35 
stepname .procstepname 

subparameter of JOB RESTART parameter 1 5-34 
stepname .procstepname . ddname 

subparameter of //*DATASET DDNAME 
parameter 21-5 

subparameter of //* FORMAT DDNAME 
parameter 21-12, 21-21 

subparameter of //*MAIN SETUP 
parameter 21-35 
storage 

real (nonpageable) 

requesting for job 15-9 



requesting for step 14-7 

virtual (pageable) 

requesting for job 15-9 
requesting for step 14-7 
STRNO 

subparameter of DD AMP parameter 10-20 
subparameter 

See also individual subparameters 

coding when multiple 3-3 

of DD DCB parameter 10-39 

syntax for 3-3 
SUBSYS 

DD statement parameter 10-127 
description 10-127 
examples 10-128 

relationship to other parameters 10-128 
subparameters 10-127 
subsystem-name 

subparameter of DD SUBSYS parameter 10-127 
subsystem-subparameter 

subparameter of DD SUBSYS parameter 10-128 
SUL 

subparameter of DD LABEL parameter 10-99 
summary chart 
symbolic 

See parameters, symbolic 
SYNAD 

subparameter of DD AMP parameter 10-20 
syntax 

for continuing statements 3-5 

format of statements 3-1 

notation for 4-1 

of parameters 4-1 

scanning for errors 1 5-40 

scanning for JCL errors without execution 14-23 
SYSABEND DD statement 

description 11-13 

examples 11-15 

location in JCL 11-13 

overriding 11-15 
SYSAFF 

parameter of JES2 /*JOBPARM statement 20-7 

relationship to JOB NOTIFY parameter 15-21 
SYSALLDA 

assumed when in-stream data set referenced 10-151 

specified in DD UNIT parameter 10-143 
SYSCHK DD statement 

description 11-17 

examples 11-19 

location in JCL 11-19 

parameters 11-17 

relationship to other control statements 11-18 
SYSCKEOV DD statement 

description 1 1 -20 

example 11-21 

location in JCL 11-21 

parameters 11-20 

relationship to DD CHKPT parameter 10-27 
SYSGROUP 

subparameter of DD MSVGP parameter 10-107 
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SYSIN DD statement 
description 11-22 
examples 11-22 
location in JCL 11-22 
parameters 11-22 
SYSMDUMP DD statement 
description 11-13 
examples 11-15 
location in JCL 11-13 
overriding 11-15 
SYSMSG 

subparameter of //*FORMAT DDNAME 
parameter 21-12 
SYSOUT 

See also sysout 

DD statement parameter 10-130 
defaults 10-132 
description 10-130 
examples 10-135 
overrides 10-132 

relationship to other control statements 10-133 
relationship to other parameters 10-132 
subparameters 10-131 
relationship to DD COPIES parameter 10-33 
with DEST = (node) 1 0-60, 1 0-6 1 
sysout (system output data set) 

associating with an OUTPUT JCL 

statement 10-112 
references to OUTPUT JCL statements 17-6 
specifying through DD SYSOUT parameter 10-130 
SYSTEM 

parameter of JES3 //*MAIN statement 21-36 
SYSUDUMP DD statement 
description 11-13 
examples 11-15 
location in JCL 11-13 
overriding 11-15 
SYSl.PROCLIB 

use for procedures 2-1 



subparameter of DCB EROPT parameter 10-45 
subparameter of DCB FUNC subparameter 10-45 
subparameter of DCB OPTCD subparameter 10-49 
subparameter of DCB RECFM 

subparameter 10-51, 10-52 
subparameter of DCB TRTCH 

subparameter 10-54 
table reference character 

See trc 
table-name 

subparameter of //* FORMAT CHARS 

parameter 21-13 
subparameter on DD CHARS parameter 10-24 
subparameter on OUTPUT JCL CHARS 

parameter 17-11 
tasks 



charts of 2-2 
for entering jobs 
chart of 2-3 
for processing jobs 

chart of 2-6 
for requesting data set resources 

chart of 2-7 
for requesting sysout data set resources 

chart of 2-10 
introduced iii, 2-1 
TCAM (telecommunications access method) 
subparameters of DD DCB parameter 10-42 
with DD statement QNAME parameter 10-120 
tcamname 

subparameter of DD QNAME parameter 10-120 
telecommunications access method 

See TCAM (telecommunications access method) 
TERM 

DD statement parameter 10-137 
description 10-137 
examples 10-138 
location in JCL 10-137 
relationship to other parameters 10-137 
subparameter 10-137 
terminals 

data coming from or going to 10-137 
termination 
abnormal 

dumps for 11-13 
normal 

dumps for 11-13 
notification of 15-21 
testing of return codes from 14-9, 15-13 
test 

of on-line terminal 10-45 
tests, return code 

specifying 14-9, 15-13 
THRESH 

subparameter of DD DCB parameter 10-53 
THRESHED 

OUTPUT JCL statement parameter 17-54 
defaults 17-54 
description 1 7-54 
example 17-55 
subparameter 17-54 
parameter of JES3 //* FORMAT PR 
statement 21-18 
THWS 

subparameter of //*MAIN SETUP 
parameter 21-35 
TIME 

EXEC statement parameter 14-31 
defaults 14-32 
description 14-31 
examples 14-33 
overrides 14-32 
subparameters 14-31 
JES2 format subparameter of JOB accounting 

information 15-6 
JOB statement parameter 15-37 



Index X-29 



Index 



defaults 15-38 
description 1 5-37 
examples 15-38 
overrides 1 5-38 
subparameters 15-37 
parameter of JES2 /*JOBPARM statement 20-7 



time 



checking by system 14-32, 15-38 
handling by system 14-32, 15-38 
subparameter of /7*MAIN DEADLINE 

parameter 21-29 
system conversion of time value 14-32, 15-38 
time out with EXEC COND parameter 14-12 
use of, by job 15-37 
use of, by job step 14-31 
TN 

character set for 1403 and 3203 Model 5 10-140, 
17-59 
TPROCESS macro instruction 

accessing TCAM messages 10-120 
TRACE 

subparameter of DCB DIAGNS 

subparameter 10-44 
subparameter of DO AMP parameter 10-20 
trace 

of OPEN/CLOSE/EOV 10-44 
tracks 

capacities 22-4, 22-5 

number per cylinder 22-3 

physical records 22-4, 22-5 

specifying in DO SPACE parameter 10-122 

subparameter of DCB CYLOFL 

subparameter 10-44 
subparameter of DCB LIMCT subparameter 10-46 
subparameter of DCB NCP parameter 10-47 
TRAIN 

parameter of JES3 //*FORMAT PR 
statement 21-18 
train-name 

subparameter of //*FORM AT TRAIN 
parameter 21-18 
translation, of labels 

specified by DD LABEL parameter 10-103 
transmission 

of input stream to network node 21-52 
TRC 

OUTPUT JCL statement parameter 1 7-56 
defaults 17-56 
description 17-56 
example 17-57 

relationship to other parameters 17-56 
subparameters 17-56 
trc 

subparameter of /*OUTPUT MODIFY 

parameter 20-21 
subparameter of /*OUTPUT MODTRC 
parameter 20-21 
subparameter of //*FORMAT FORMS 

parameter 21-17 
subparameter of DD MODIFY parameter 10-105 



subparameter of OUTPUT JCL MODIFY 

parameter 1 7-47 
TRIPLE 

subparameter of //*FORMAT CONTROL 

parameter 21-14 
subparameter of OUTPUT JCL CON IROL 
parameter 17-21 
TRK 

subparameter of DD SPACE parameter 10-122 
TRKGRPS 

parameter of JES3 //*MAIN statement 21-37 
TRTCH 

subparameter of DD DCB parameter 10-54 
TS 

subparameter of DD TERM parameter 10-137 
TYPE 

parameter of JES3 //*MAIN statement 21-38 
type 

subparameter of //*FORMAT DEST 

parameter 21-15, 21-23 
subparameter of //*MAIN DEADLINE 

parameter 21-29 
subparameter of OUTPUT JCL DEST 
parameter 17-30 
TYPRUN 

JOB statement parameter 1 5-40 
description 1 5-40 
example 15-41 

relationship to other control statements 15-41 
subparameters 1 5-40 
Til 

character set for 32 1 1 1 0- 1 40, 1 7-59 



U 



U 

subparameter of DCB OPTCD 

subparameter 10-49, 10-50 
subparameter of DCB RECFM 
subparameter 10-51, 10-52, 10-53 
UCS 

DD statement parameter 10-139 
defaults 10-140 
description 10-139 
examples 10-141 
overrides 10-140 

relationship to other parameters 10-141 
subparameters 10-139 
OUTPUT JCL statement parameter 17-58 
defaults 17-58 
description 17-58 
example 17-60 
overrides 17-59 
subparameter 17-58 
parameter of JES2 /*OUTPUT statement 20-22 
Un 

parameter of JES2 /*ROUTE statement 20-26 
subparameter of /*0UTPUT DEST 
parameter 20-18 
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subparameter of DD DEST parameter 10-60 
subparameter of OUTPUT JCL DEST 
parameter 17-29 
UNCATLG 

subparameter of DD DISP parameter 10-65, 10-66 
UNIT 

DD statement parameter 10-142 
description 10-142 
examples 10-146 
location in JCL 10-146 
overrides 10-145 

relationship to other parameters 10-145 
subparameters 1 0- 1 42 
relationship to DD COPIES parameter 10-33 
unit affinity 

specifying in AFF subparameter 10-144 
when DDNAME parameter is also coded 10-56 
unit-count 

subparameter of DD UNIT parameter 10-143 
unqualified 

See name 
UPDATE 

parameter of JES3 //*MAIN statement 21-38 
uppercase 

in syntax 4-2 
USER 

JOB statement parameter 1 5-42 
defaults 15-42 
description 15-42 
example 15-43 

relationship to other parameters 1 5-43 
parameter of JES3 //*MAIN statement 21-38 
subparameter 15-42 
user labels 
See AUL 
See SUL 
USERID 

parameter of JES3 //*NETACCT statement 21-45 
userid 

data coming from or going to 10-137 
parameter of JES2 /*NOTIFY statement 20-12 
parameter of JES2 /* ROUTE statement 20-26 
parameter of JES2 /*XMIT statement 20-34 
subparameter of /*OUTPUT DEST 
parameter 20-18 
subparameter of //*MAIN USER parameter 21-38 
subparameter of //*NETACCT USERID 

parameter 21-45 
subparameter of DD DEST parameter 10-60, 

10-61 
subparameter of JOB NOTIFY parameter 15-21 
subparameter of JOB USER parameter 15-42 
subparameter of OUTPUT JCL DEST 
parameter 17-29 



V 
V 



subparameter of AMP RECFM 

subparameter 10-20 
subparameter of DCB RECFM 

subparameter 10-51, 10-52, 10-53 
subparameter of DD DSID parameter 10-75 
valueK 

subparameter of EXEC REGION parameter 14-29 
subparameter of JOB REGION parameter 15-32 
value M 

subparameter of EXEC REGION parameter 14-29 
subparameter of JOB REGION parameter 15-32 
value 1 

subparameter of EXEC DPRTY parameter 14-15 
value2 

subparameter of EXEC DPRTY parameter 14-15 
VB 

subparameter of AMP RECFM 
subparameter 10-20 
VBS 

subparameter of DCB RECFM 
subparameter 1 0-5 1 
verification 

of FCB image 10-87 
of forms overlay frame 10-91,17-34 
VERIFY 

subparameter of DD FCB parameter 10-87 
subparameter of DD UCS parameter 10-139 
VIRT 

subparameter of EXEC ADDRSPC 

parameter 14-7 
subparameter of JOB ADDRSPC parameter 1 5-9 
virtual storage 

See storage, virtual (pageable) 
virtual storage access method 

See VSAM (virtual storage access method) 
vmguestid 

parameter of JES2 /* ROUTE statement 20-27 
parameter of JES2 /*XEQ statement 20-32 
parameter of JES2 /*XMIT statement 20-34 
parameter of JES3 //*ROUTE XEQ 21-52 
VOLUME 

DD statement parameter 10-147 
description 10-147 
examples 10-152 
in JES3 system 10-152 
overrides 10-151 

relationship to other parameters 10-151 
subparameters 10-148 
volume-count 

subparameter of DD VOLUME parameter 10-149 
volume-sequence-number 

subparamtter of DD VOLUME parameter 10-149 
volumes 

nonspecific requests 
allocation of 10-123 
specifying 10-152 
volume counts for 10-149 
number of 

affect on number of devices allocated 10-143 
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specifying by volume-count 
subparameter 10-149 
private 

specifying in PRIVATE subparameter i 0-1 48 
retention 

specifying by RETAIN subparameter 10-148 
serial numbers 

specifying by SER subparameter 10-149 
VS 

subparameter of DCB RECFM 
subparameter 10-51 
VSAM (virtual storage access method) 
referenced in VOLUME = REF 

subparameters 10-151 
with DD AMP parameter 10-17 
VS2 

subparameter of //*MAIN TYPE parameter 21-38 



W 



W 

subparameter of //*MAIN BYTES 

parameter 21-27 
subparameter of //*MAIN CARDS 

parameter 21-28 
subparameter of //*MAIN LINES parameter 21-32 
subparameter of //*MAIN PAGES 

parameter 21-34 
subparameter of DCB FUNC subparameter 10-45 
subparameter of DCB OPTCD 
subparameter 10-48, 10-49, 10-50 
WARNING 

subparameter of //*MAIN BYTES 
parameter 21-27 
subparameter of //*MAIN CARDS 

parameter 21-28 
subparameter of //*MAIN LINES parameter 21-32 
subparameter of //*MAIN PAGES 
parameter 21-34 
work-station-name 

parameter of JES3 /*SIGNON statement 21-55 
WRITER 

OUTPUT JCL statement parameter 17-61 
defaults 17-61 
description 17-61 
example 17-62 
overrides 17-61 
subparameter 17-61 
writer-name 

starting external writer 10-133, 17-61 
subparameter of DD S YSOUT parameter 10-131 
with DEST = (node) 10-60,10-61 
writer, external 

specifying on OUTPUT JCL statement 17-61 
specifying on sysout DD statement 10-130 
with OUTPUT JCL WRITER parameter 17-61 
with SYSOUT writer-name parameter 10-133 



X 



X 

subparameter of DCB FUNC subparameter 10-45 
subparameter of DCB LRECL subparameter 10-46 
subparameter of DCB PCI subparameter 10-50 

X 

subparameter of /*JOBPARM FORMS 

parameter 20-6 
subparameter of /*JOBPARM ROOM 

parameter 20-7 
subparameter of /*OUTPUT CHARS 

parameter 20-16 
subparameter of /*OUTPUT FCB parameter 20-19 
subparameter of /*OUTPUT FORMS 

parameter 20-20 
subparameter of /*OUTPUT UCS parameter 20-22 
subparameter of /*XMIT DLM parameter 20-34 
subparameter of //*MAIN PROC parameter 21-34 
subparameter of DCB EROPT subparameter 10-45 
XEQ 

parameter of JES2 /* ROUTE statement 20-25 
XN 

character set for 1403 and 3203 Model 5 10-140, 

17-59 



Y 



See also YES 
subparameter of 

parameter 20- 
subparameter of 

parameter 20- 
subparameter of 

parameter 20- 
subparameter of 
subparameter of 
YES 

subparameter of 

parameter 21- 
subparameter of 

parameter 21- 
subparameter of 

parameter 21- 
subparameter of 
subparameter of 

parameter 21- 
subparameter of 

parameter 21- 
subparameter of 

parameter 21- 
subparameter of 

parameter 21- 
subparameter of 
subparameter of 
subparameter of 
subparameter of 

parameter 17- 



/*JOBPARM BURST 

5 

/*JOBPARM RESTART 

6 

/♦OUTPUT BURST 

16 

DCB OPTCD subparameter 10-50 

DD PROTECT parameter 10-117 

//*DATASET DDNAME 

6 

//♦FORMAT FORMS 

23 

//*MAIN EXPDTCHK 

30 

//*MAIN HOLD parameter 21-31 

//*MAIN JOURNAL 

32 

//*MAIN RINGCHK 

35 
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